portals 

package com. dcr . dvg .model . portal . dii 
* @ (#) PortalDirectoryModel . java 



! the model of 



Edward L. Stull 
JDKl . 1 
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import jav 






import jav 


a.io.File; 




import j av 


a.util.Date; 




import j av 


ax . swing . event . TableModelListener ; 




import j av 


ax . swing . table . TableModel ; 




import j av 


ax . swing . tree . TreeNode ; 




import com 


. dcr . dvg .model . datasource . directory -DataSourceDirectoryModel ; 




import com 


. dcr . dve . model . mdb . IMCTreeTableModel ; 






. dcr . dve . model .mdb . IMDbUserComponent ; 




import com 


. dcr . dvg .model . tree . explorer . ExplorerDirectoryModel ; 




import com 


. dcr . dvg . model . tree . explorer . TreeDirectoryModel ; 




import com 


. dcr . dvg . model . tree . TreeNodeModel ; 






. dcr . dvg . util . throwable . DVException; 




import con 


. dcr -dvg .util . throwable .UnableToSavePortalDirectoryFileExcept 


0; 


public cla 


ss PortalDirectoryModel 



extends ExplorerDirectoryModel ■ 



/ / Types of the columns . 
static protected Class [] portalAtt: 
String. class} ; 



"Modified" , 



Date . class. 



public static 
protected tra 



boolean TRACE = 



rtalDirectoryModel ; 



* Constructor. 
*/ 

public PortalDii 



ctoryModel ( ) { 



setRoot ( (TreeNodeModel) getNewMode I ( ) . getRoot ( ) ) ; 
sessionModel = this; 

} 

/** 

* Constructor with a root of the specif iec PortalFolderModel . 

* <p> 

* @paratn folder - PortalFolderModel - the root of the model 
*/ 

protected PortalDirectoryModel (PortalFolderModel folder) { 
super (new PortalDirectoryFolderNodeModel (folder) ) ; 



I table model listener. 
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* (Sparam listener - TableModelListener 
*/ 

public void addTableModelListener (TableModelLi 
// do nothing for now 

} 

/** 

* Implements IMCTreeTableModel . 

* <p> ^ 

* Gets the column class (indicator) . 

* <p> 

* @param column - int - class indicator 
public Class getColumnClass (int column) { 

1 portalAttributeTypes [column] ; 



/** 

* Implements IMCTreeTableModel . 

* <p> 

* Gets the column count . 

* <p> 

* (Sparam columnCount - int 
public int getColumnCount ( ) { 

return portalAttributeNames . length; 

} 



* Implements IMCTreeTableModel. 

* <p> 

* Gets the column name. 

* <p> 

* @param columnName - String 
*/ 

public String getColumnName ( mt colui 



portalAttributeNames [column] ; 



* Implements javax. swing . table .TableModel . 

* Gets the number of records managed by the data source object. 

* <B>JTable</B> uses this method to determine how many rows it ^ 

* should create and display. This method should be quick, as it 

* is call by <B>JTable</B> quite frequently. 

iws in the model 



public int getRowCount ( ) { 

return getRowCount ( (TreeNode) getRoot <) , 



* Implements javax. swing. table . TaileModel . 

* <p> 

* Gets the number of records managed by the data s 

* <B>JTable</B> uses this method to determine how many rows it ^ 

* should create and display. This method should be quick, as i 

* is call by <B>JTable</B> quite frequently. 

* ©return rowCount - int - the number or rows in the model 

* @see #getColumnCount 

public int getRowCount (TreeNode treeNode, int start ingRowCount) 
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int rowCount = startingRowCount ; 



for (int i = 0; i < ( (TreeNode) treeNode) . getChildCount () ; 

TreeNode childNode = (TreeNode) getChild (treeNode, i) ; 
if (! ChildNode . isLeaf () ) 

rowCount += getRowCount (childNode, rowCount); 



} 

/** 

* Gets the shared session model. 

* ©return sessionModel - PortalDirectoryModel 
piiblic static PortalDirectoryModel getSessionModel () { 

lessionModel; 



* Gets the stock Portal Directory Model . 

* <p> 

* ©return stockModel - TreeDirectoryModel 
*/ 

pixblic TreeDirectoryModel getStockModel ( ) { 

traceMessageC Initializing the stock Portal Directory Model"); 

PortalFolderModel folder = new Portal FolderModel ( "Registered Portals 
Jan 01", "DataVantage Global"); 

1 PortalDirectoryModeK folder) ; 



7 and column. 



* ®paraiti row - int 

* @param column - int 

* ©return value - Object 
*/ 

public Object getValueAt ( int ] 



/** 

* Implements IMCTreeTableModel . 

* <p> 

* Gets the value at a folder and column. 

* <p> 

* @param folder - PortalFolderModel 

* ©paratn column - int 

* ©return value - Object 

public Object getValueAt (PortalFolderModel folder, int column) { 

Object value = null; 
try { 

switch (column) { 

case 0: // Name 

value = folder . getName ( ) ; 

case 1: // Modified 

value = folder .getLastUpdatedDate () ; 

case 2 : //Owner 

value = folder . getOwner { ) ; 

} 



} catch (SecurityExceptic 

} 



* Indirect support for implementation IMCTreeTableModel . 

* <p> 

* Gets the value at a portal and column. 

* <p> 

* @param portal - PortalModel 

* ®param column - int 

* ©return value - Object 
*/ 

public Object getValueAt ( PortalModel portal, int column) ■ 

Object value = null; 
try { 

switch (column) { 

case 0 : // Name 

value = portal . getName ( ) ; 

case 1: // Modified 

value = portal . getDate ( ) ; 

case 2 : "//O^wn^er 

value = portal . getOwner ( ) ; 

} 

) catch (SecurityException se) { 
value = "ERROR" ; 

} 



* Implements IMCTreeTableModel. 

* <p> 

* Gets the value at a node and column. 

* <p> 

* ®param node - Object 

* ©param. column - int 

* ©return value - Object 
*/ 

public Object getValueAt (Object node, int column) { 

Object value = null; 

IMDbUserComponent typedNode = 
(IMDbUserCoraponent) ( (PortalDirectoryNodeModel) node) .getDirectoryNodeComponent ( 
if (typedNode instanceof PortalModel) 

value = getValueAt {{ PortalModel ) typedNode , column); 

else 

value = getValueAt ( (Portal FolderModel) typedNode, column); 



* Implements j avax . swing . table . TableModel . 

* <p> 

* Answer if the cell is editable. 

* <p> 

* Oparam row - int 

* ®param column - int 

* ©return mode - boolean 
*/ 

public boolean isCellEditable (int row, int c 
I false; 



* Implements IMCTreeTableModel . 

* <p> 

* Answer if the cell is editable. 

* <p> 

* @param node - Object 

* @param column - int 

* ©return mode - boolean 
*/ 

public boolean isCellEditable (Object node, int column) { 
return false; 

} 

/** 

* Opens a DirectoryModel from a file. 

* <p> 

* dparam file - File 
*/ 

public void openModelln (File file) { 
try { 

setSessionModel ( (PortalDirectoryModel) getModelln (f ile) ) ; 
} catch. (Throwable throwable) { 
} 

Fi: 

"_DS.ser") 

if (file.existsO) 

DataSourceDirectoryModel . getSessionModel () . openModelln (dataSourceDirectoryFile) 



* Implements j avax . swing . table . TableModel . 

* <p> 

* Remove a table model listener 

* Oparam listener - TableModelListener 
*/ 

public void removeTableModelListener (TableModelListener 1: 
//do nothing 



/** 

* Implements resetTransient Values ( ) . 

* Reset the transient values in the just- loaded 
piiblic void resetTransient Values ( ) { 



/** 

* Save (serialize) the Directory Model. 

* Override the super to also save the Data Source Directory. 

* <p> 

* @param file - File 
*/ 

public void saveAs<File file) throws Exception { 
super. saveAs (file) ; 



//also save the data s 
DataSourceDirectoryModel .getSessionModel () . saveAs ( 

new File (file. getName C) . substring ( 0 , f ile .getName (> . lastlndexof ( " . ser" ) ) 
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} 

/** 

* Sets a new (i.e., empty) Directory Model. 
*/ 

public void setNewModel ( ) { 

setSessionModel ( (PortalDirectoryModel) getNewModel ( ) ) ; 

int [] childlndices = new int [1] ; 
childlndices [0] = 1; 

TreeNode newChild = (TreeNode) getSessionModel ( ) .getRoot ( ) ; 
Object[] newChildren = new Object [1]; 
newChildren [0] = newCliild; 

f ireTreeNodesInsertedCthis, getPathToRoot (newChild) , childlndices, 
newChildren) ,- 

traceMessage (getClass () + "#setNewModel () Successfully setup a new Directory 
Model") ; 
} 

* Sets the shared session model. 

* @param sessionModel - PortalDirectoryModel 

public static void setSessionModel (PortalDirectoryModel model) { 
sessionModel = (PortalDirectoryModel) model ; 



* @parara value - Object 

* iSparam row - int 

* Oparam column - int 
*/ 

public void setValueAt (Objei 
// do nothing here 



* ©param value - Object 

* Oparam column - int 

public void setValueAt (Object value. Object node, int column) { 
//do nothing here 

} 
} 

package com . dcr . dvg . model . portal . directory ; 

* @(#) PortalFolderModel. java 
* 

class that is the model of 

* ©author Edward L. Stull 

* (aversion 1.6 

* ©since JDKl . 1 
*/ 

//34567890123456789012345678901234567890123456789*123456789012345S78901234567890 
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import j ava . awt . Image ; 
import java.util .Date; 



import com . dcr . dvg . model . Transient ChangeOwnerModel ; 

import com . dcr . dve . mode 1 . radb . IMDbUserComponent ; 

import com . dcr . dvg . model . tree . explorer . lExplorerFolderModel ; 

public class PortalFolderModel 

extends Transient ChangeOwnerModel 

implements IMDbUserComponent, lExplorerFolderModel { 
protected String name; 

protected String lastUpdatedDate ; //date of creat: 
protected String owner; 



* Empty constructor. 
*/ 

public PortalFolderModel 0 



/** 

* Constructor. 

* <p> 

* @param name - j ava . lang . String - folder name 

* ©parara lastUpdatedDate - j ava . lang . String 

* ©param owner java. lang . String 

public PortalFolderModeK String name. String lastUpdatedDate, String owner) { 
this. name = name; 

this. lastUpdatedDate = lastUpdatedDate; 
} thxs. owner owner. 



* Creates a new PortalFolderModel which is a copy of this one. 

* ©return an identical copy of this PortalFolderModel 
V 

public Object clone () { 

PortalFolderModel newPortalFolderModel = new PortalFolderModel ( ) ; 
//copy only local instance vars 

newPortalFolderModel . setDate (new String (getLastUpdatedDate { ) ) ) ; 
newPortalFolderModel . setName (new String (getName () ) ) ; 
newPortalFolderModel . setOwner (new String (getOwner ( ) ) ) ; 

// Return the newly created PortalFolderModel copy 
return (Object) newPortalFolderModel; 

} 



/* 

* Gets the last updated date. 

* <p> 

* ©return lastUpdatedDate - String 
piiblic String getLastUpdatedDate ( ) { 

return lastUpdatedDate; 

} 



/* 

* Gets the last updated date. 

* <p> 

* ©return date timestamp 

public static String getLastUpdatedDateDef ault { ) { 
return new Date ( ) . toString ( ) ; 



* Gets the name of the connection. 

* ©return String 
*/ 

public String getName ( ) { 
} 

/** 

* Gets the default name. 

* <p> 

* ©return String 
*/ 

public static String getNameDef ault ( ) { 
return "« NAME OF FOLDER >>"; 

} 

* Gets the owner. 

* @return String 
*/ 

public String getOwnerO { 



/** 

* Gets the default owner. 

* <p> 

* ©return String 
*/ 

piiblic static String getOvmerDef ault ( ) 
return "<< OWNER OF FOLDER >>" ; 

} 



* Sets the last updated date. 

* <p> 

* ®param date a canonical string representation of the date. The result 

* is of the form <code>"Sat Aug 12 02:30:00 PDT 1995"</code> . 
*/ 

public void setDate (String lastUpdatedDate) { 
this.lastUpdatedDate = lastUpdatedDate; 

/** 

* Sets the name. 

* <p> 

* @param name String 
*/ 

public void setName (String name) { 
} 

/** 

* Sets the owner. 

* <p> 

* ©pararn String 
*/ 

public void setOwner (String owner) { 



package com. dcr .dvg . model .portal . directory; 



* ®{#)PortalFolderModel.java 

* <p> 




* The <code>PortalFolderModel</code> class that is the model of 

* a Portal Folder. 

* <p> 

* (Sauthor Edward L. Stull 

* ©version l.S 

* ©since JDKl . 1 

//345S78901234567890123456789012345S789012345S78 9*123456789012345S78901234567890 

itoport j ava . awt . Image ; 
import java.util .Date; 

import com . dcr . dvg . model . TransientChangeOwnerModel ; 

import com. dcr .dve .model .mdb. IMDbUserComponent ; 

import com. dcr . dvg . model . tree . explorer . lExplorerFolderModel ; 

public class PortalFolderModel 

extends TransientChangeOwnerModel 

implements IMDbUserComponent, lExplorerFolderModel { 
protected String name; 

protected String lastUpdatedDate; //date of creation, e.g., "X993 Mar i: 

protected String owner; // e.g., "George Lang" 

^^Empty constructor 

public PortalFolderModel { ) { 
} 



/** 

* Constructor. 

* <p> 

* (gparam name - j ava . lang . String - folder name 

* Oparam lastUpdatedDate - j ava. lang. String 

* @param owner j ava . lang. String 

public PortalFolderModel (String name. String lastUpdatedDate, String owner) { 
this. name = name; 

this. lastUpdatedDate = lastUpdatedDate; 
this. owner = owner; 

} 



* Creates a new PortalFolderModel which is a copy of this one. 

* ©return an identical copy of this PortalFolderModel 
*/ 

public Object clone () { 

PortalFolderModel newPortalFolderModel = new PortalFolderModel <) ; 
/ / copy only local instance vars 

newPortalFolderModel . setDate (new String {getLastUpdatedDate ( ) ) ) ; 
newPortalFolderModel . setName (new String (getName ( ) ) ) ; 
newPortalFolderModel . setOwner (new String (getOwner ( ) ) ) ; 

// Return the newly created PortalFolderModel copy 
return (Ob j ect > newPortalFolderModel ; 

} 



* Gets the last updated date. 

* <p> 

* ©return lastUpdatedDate - String 
public String getLastUpdatedDate ( ) { 

return lastUpdatedDate; 

} 



/* 

* Gets the last updated date. 

* <p> 

* ©return date time stamp 

public static String getLastUpdatedDateDef ault () { 
return new DateO .toStringO ; 

} 



/** 

* Gets the name of the connection. 

* <p> 

* ©return String 
*/ 

public String getName { ) { 



/** 

* Gets the default name. 

* <p> 

* ©return String 
*/ 

ptiblic static String getNameDef ault () 
c NAME OF FOLDER »"; 



} 

/** 

* Gets the owner. 

* <p> 

*/ 

public String getOwnerO { 
} 



* Gets the default owner . 

* <p> 

public static String getOwnerDef ault ( ) { 



* Sets the last updated date. 

* @param date a canonical string representation of the date. The : 

* is of the form <code>"Sat Aug 12 02:30:00 POT 1995 " </code> . 

public void setDate (String lastUpdatedDate) { 

this. lastUpdatedDate = lastUpdatedDate; 
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* <p> 

* ©pararti name String 
*/ 

public void setName (String name) { 



/** 

* Sets the owner. 

* <p> 

* @param String 
*/ 

public void setOwner {String owner) { 
this. owner = owner; 

} 
} 

package 



i.dcr . dvg . view. controller .portal ; 



* @<#) PortalDirectory. jai 

* <p> 



* The <code>PortalDirectory</code> is the view of a Portal Directory Model. 

* <p> 

* ©author Edward L. Stull 

* ©version 1.0.10 

* ©since JDK 2 

//3455789012345S789012345678901234567890123456789*123456789012345678901234 567 



import H 

import j 
import ; 
import : 
import ; 
import ; 

import ; 

import ; 

import ; 
import j a^ 

import coi 
import coi 



c . swing . 
c . swing , 
c . swing 



JScrollPane; 
JTable; 

event . ListSelectionEvent ; 
event. ListSelectionListener; 
event .TreeExpansionEvent ; 
event .TreeExpansionLi St ener; 
event . TreeModelEvent ; 
event . TreeModelListener ; 
event . TreeSelect ionEvent ; 
event . TreeSelect ionListener; 
event .TreeWillExpandListener , • 
tree -Def aultMutableTreeNode.- 
tree .TreePath; 



a . klg . j class . util . JCListenerBist ; 

n. klg . j class .util . swing . Def aultRowSortTableModel ; 
ti. klg. j class, util . swing. JCSortableTable; 



import com. dcr. dvg .model .portal . directory . PortalModel ; 
import com. dcr. dvg. model .portal . directory . PortalFolderModel ; 
import com. dcr .dvg. model .portal . directory . PortalDirectoryFolderNodeModel ; 
import com. dcr .dvg. model .portal .directory. PortalDirectoryModel; 
import com. dcr .dvg .model .portal . directory . PortalDirectoryPortalNodeModel ; 
.mport com. dcr . dvg . model . tree . explorer . lExplorerFolderModel ; 
import com . dcr . dvg . util . throwable . DVException; 
import com. dcr .dvg. view. component .tree .DVGTree; 

import com . dcr . dvg . view . component . treeexplorer . TreeExplorerNodeChildrenTable ; 
import com . dcr . dvg . view . component . treeexplorer . TreeExplorer ; 
import com . dcr . dvg . view . controller . directory . ExplorerDirectory ; 



piiblic class PortalDirectory extends ExplorerDirectory { 



protected PortalDirectoryFolderNodeModel treeRoot = null; 

* <p> 

* @param portalDirectoryFolderNode PortalDirectoryFolderNodeModel 
public PortalDirectory (PortalDirectoryFolderNodeModel treeRoot) { 

super 0 ; 

/*DVG deleted*///tliis. treeRoot = treeRoot; IGHORE THIS, FIX LATER 
PortalDirectoryModel . getSessionModel ( ) . openModelln (new 
FileCPortalDirectoryModel.getSessionModeK) . getDef aultSerializationFileName ( ) ) ) ; 
updateViewO ; 

} 



* Adds a listener for data source selection events. 

* ©param tsl tlie DataSourceSelectionListener that will be notified when 

* a node is selected or deselected (a "negative 

public void addDataSourceSelectionListener ( IPortalDirectorySelectionListener listener) 
{ 

listeners = JCListenerList . add ( listeners , listener); 

} 



* Fires a terminal (i.e.. Portal) Selection Event. 

* Oparam tsl the IPortalDirectorySelectionListener that will be notified when 

* a node is selected or deselected (a "negative selection") 

public void f ireTerminalSelectionEvent < ) { 

PortalDirectorySelectionEvent portalSelectionEvent = new 
PortalDirectorySelectionEvent (this) ; 

Enumeration e = JCListenerList . elements (listeners) ; 
for (; e .hasMoreElements 0 ; ) { 

IPortalDirectorySelectionListener listener = 
(IPortalDirectorySelectionListener) e . nextElement ( ) ; 

listener .portalSelectionChanged (portalSelectionEvent) ; 

} 

} 



/* 

* Gets the folder that owns the selected Portal . 

* <p> 

* ©return folder 
*/ 

public PortalDirectoryFolderNodeModel getFolderNodeOfSelectedPortal () { 

return ( PortalDirectoryFolderNodeModel ) getFolderNodeOf SelectedNode ( ) ; 

} 



* Gets the Portal Directory Model. 

* <p> 

* ©return portalDirectoryModel - PortalDirectoryModel 
public PortalDirectoryModel getPortalDirectoryModel {) { 

return (PortalDirectoryModel) treeExplorer. getTreeTableModel 0 ; 

} 



* Gets the selected (host) folder. 
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* ©return explorerFolder - lExplorerFolderModel 
public lExplorerFolderModel getSelectedFolder ( ) { 

return getSelectedPortalFolder ( ) ; 

} 

* Gets the selected db connection from the connection tree. 

* <p> 

* ©param selectedPortal - PortalModel - returns null if no 
*/ 

public PortalModel getSelectedPortal ( ) 
throws DVException { 

try { 

TreePath treePath = treeExplorer . getSelectionPath ( ) ; 
if (treePath != null) { 

Object select edCoraponent = treePath.getLastPathComponent () ; 

if (selectedComponent instanceof PortalDirectoryPortalNodeModel) 

(PortalModel) { (PortalDirectoryPortalNodeModel) selectedComponent) .getPortalO ; 
} catch (Exception exception) { 



* Get sthe selected db connection folder from the 

* <p> 

* @param portalFolderModel - PortalFolderModel 

public PortalFolderModel getSelectedPortalFolder { ) { 

TreePath treePath = getTree () .getSelectionPath () ; 
if (treePath != null) { 

Object selectedComponent = treePath.getLastPathComponent () ; 

if (selectedComponent instanceof PortalDirectoryFolderNodeModel) 



(PortalFolderModel) ( (PortalDirectoryFolderNodeModel) selectedComponent) . getDirectoryNod 
eComponent { ) ; 
} 

return null; 



* Gets the selected data source node in the data source directory. 

* <p> 

* ®param selectedPortalNode - PortalModel - returns null if no data source is 
selected 

*/ 

public PortalModel getSelectedPortalNode { ) 
throws DVException { 

try { 

TreePath treePath = treeExplorer . getSelectionPath () ; 
if (treePath != null) { 

Object selectedComponent = treePath.getLastPathComponent {) ; 

if (selectedComponent instanceof PortalDirectoryPortalNodeModel) 



(PortalModel) ( (PortalDirectoryPortalNodeModel) selectedComponent) .getDirectoryNodeCompo 
nentO ; 

} catch (Exception exception) { 
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* Gets the selected data e 

* <p> 

■ TreePath[] 

public TreePath[] getSelectedPortalPaths ( ) { 

TreePath[] treePaths = treeExplorer .getSelectionPaths ( ) ; 

TreePath[] portalPaths = null; 
if (treePaths != null) { 

TreePath[] temporarySelectedPortalPaths = new 
TreePath [treePaths . length] ; 

int portalPathCount = 0 ; 

for (int i = 0; i< treePaths . length; i++) { 

if (treePaths [i] .getLastPathComponent {) instanceof 
PortalDirectoryPortalNodeModel) { 

temporarySelectedPortalPaths [portalPathCount] = 

treePaths [i] ; 

portalPathCount++ ; 

} 

} 

portalPaths = new TreePath [portalPathCount] ; 

System. arraycopy (temporarySelectedPortalPaths, 0, portalPaths, 
portalPathCount) ; 
} 

portalPaths ; 



selected data sources from the data source directory i 
PortalModel [] - returns null if no at; 

public PortalModel [} getSelectedPortals 0 
throws DVException { 

TreePath[] treePaths = treeExplorer .getSelectionPaths () ; 

PortalModel [] portals = null; 
if (treePaths != null) { 

PortalModel [] temporaryPortals = new PortalModel [treePaths . length] ; 

int portalCount = 0; 

for (int i = 0; i< treePaths . length; i++) { 

Object selectedComponent = treePaths [i] . getLastPathComponent () ; 
if (selectedComponent instanceof PortalDirectoryPortalNodeModel) 

^ temporaryPortals [portalCount] = 

(PortalModel) ( (PortalDirectoryPortalNodeModel) selectedComponent) .getPortalO ; 
portalCount++; 

} 

} 

portals = new PortalModel [portalCount] ; 

System. arraycopy (temporaryPortals, 0, portals, 0, portalCount); 



* Gets the TreePath of the selected row inside the directory's table ^ 

* <p> 

* @param getSelectionPath - TreePath 
*/ 

public TreePath getSelectionPath () ( 

return treeExplorer . getSelectionPath ( ) ; 

} 

/** 
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piiblic void initO { 



super. init () ; 

JCSortableTable se = ( JCSortableTable) treeExplorer . getTable ( ) ; 

// set keys to define the sort-order wlien clicking on certain columns 

int keysO [] = {2, 0 } ; 

se.setKeyColumns (0, keysO) ; 

int keysl [] = {2, 1, O}; 

se. setKeyColumns (1, keysl); 

int keys2 [] = {2, 0} ; 

se . setKeyColumns ( 2 , keys2 ) ; 

// assume we have a few rows, and expand 
getTree ( ) . expandRow (2) ; 
getTreeO . expandRow (1) ; 
getTree 0 . setSelectionRow (2) ; 

} 



* Removes a listener for data source selection (i.e., TreeSelection) events. 

* Oparara listener - the DataSourceDataSourceDirectorySelectionListener that will be 
notified when 

* a node is selected or deselected (a "negative 

* selection") 

public void removePortalSelectionListener (PortalDirectorySelectionListener listener) { 
listeners = JCListenerList .remove (listeners, listener); 

} 



* Sets the <code>PortalDirectoryModel</code> model, 
public void setModel ( PortalDirectoryModel model) { 
this. model = model; 

} 



/** 

* Updates the view. 
*/ 

public void updateViewO { 

traceMessageC'reloadModel >> reloading datasource model into the datasource 
diretory" ) ; 

if (getModelO != null) { 
removeAl 1 { ) ; 

getModelO . removeTreeModelListener (this) ; 

} 

treeRoot = 

(PortalDirectoryFolderNodeModel) PortalDirectoryModel .getSessionModel () .getRoot () ; 

PortalDirectoryModel model = new PortalDirectoryModel () ; 

PortalDirectoryModel .getSessionModel 0 . setRoot (treeRoot) ; 

setModel (model) ; 

// must follow setModel 

model . addTreeModelListener (this) ; 

init ( ) ; 

getTreeO . expandRow ( 0 ) ; 
getTreeO . addSelectionRow (0) ; 
f ireTerminalSelectionEvent ( ) ; 

refresh () ; 

} 
} 

package com . dcr . dvg . view . controller . portal ; 
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sctoryControlle] 



* The <code>PortalDirectoryCoiitroller</code> 



; be the superclass of any 





DataVantage Global . 


* <p> 




* ©author 


Edward L. Stull 


* Oversioi 


a 1.26 




JDK 2 


//345678901234567890123456789012345678 


import j av 


i.awt .Cursor; 


import j av 


a. . awt . Dimension; 


import j av 


a . awt . Image ; 


import j av 


a . awt . event . MouseAdapter ; 


import j av 


i . awt . event . MouseEvent ; 


import j av 


i . awt . event .MouseListener ; 


import jav 


a . beans . PropertyChangeEvent ; 


import j av 


a.io.File; 


import j av 


a. io. lOException; 


import j av 


a. net. URL; 


import j av 


a.util.Hashtable; 


import jav 


ax . swing . JLayeredPane ; 


import j av 


ax. swing. text .TextAction; 


import jav 


ax. swing. tree -TreePath; 


import j av 


ax . swing . Action; 



import com 
import com 

import com 
import com 
import com 
import com 

.mport com 
import com 
import com 
import com 
import com 
import com 

import com 

import com 

import com 
import com 

import com 
import com 
import com 
import com 

import com 
import com 

import com 
import 
com. dcr . dvg 
import 
com. dcr -dvg 



dcr . dve . model . muser . MUserContext ; 
dcr . dve . view . vcomponent . VCBorder Layout ; 
dcr .dve. view. vcomponent .vccontrol .VCControlBar ; 
dcr . dve . view . vcomponent . VCSplitViewer ; 
dcr . dve . view . vcomponent . vcdialog . VCOptionDialog ; 
dcr . dve . view . vcomponent . vcpanel . VCScrollViewer ; 
dcr . dve .view . vprocess . IVPView; 
dcr .dvg. view. component . desktop .DVGDesktop; 



dcr . dvg 
dcr . dvg 
dcr . dvg 
dcr . dvg 

dcr . dvg 
dcr . dvg 
dcr . dvg 
dcr . dvg 

dcr. dvg.Ti 
dcr. dvg. 
dcr .dvg. \ 
dcr . dvg . \ 
dcr . dvg . \ 
dcr . dvg . -<. 
dcr. dvg. 

dcr .dvg. 
dcr. dvg. -s 
dcr -dvg .A 
dcr .dvg .1 

dcr. dvg. 
dcr. dvg. 



model . portal . directory . PortalModel ; 
model . portal . directory . PortalFolderModel ; 
model .portal . directory . PortalDirectoryFolderNodeModel; 
model .portal .directory . PortalDirectoryPortalNodeModel; 
, model . portal . directory . Por talDirectoryModel ; 
.model .portal .directory . PortalDirectoryNodeModel ; 
.model . tree . ITreeFolderNodeModel ; 
model . tree . explorer . TreeDirectoryModel ; 
util . throwable .DVException; 

util . throwable .UnableToSavePortalDirectoryFileException 
component . desktop . DVGDesktop; 
controller . directory . DirectoryController ; 
controller .directory .DirectoryControllerAction; 
controller . directory . ExplorerDirectory ; 



w . controller . portal 
w . controller . portal 
w . controller . portal 
w . controller . portal 
w . controller . portal 
w . controller . portal 
w . cont r ol 1 er . por tal 
w. controller .portal 
w. controller .portal 
w . controll er . portal 

w. controller -portal 
w . controller . portal 
w . controller . portal 
w . controller . portal 



T . controller . portal . act ic 



tPortalFolderAction; 
i.AddPortalFolderAction; 
L.EditPortalAction; 
L.AddPortalAction; 
1 . OpenPort alAct ion ; 
i.NewPortalDirectoryAction; 
1 . OpenPortalD irecrtoryAct ion ; 
X. SavePortalDirectoryAction; 
i.SaveAsPortalDirectoryAction; 
i.DeletePortalDirectoryElementActic 



action.CopyPortalDirectoryElementAction; 

CutPortalDirectoryElementAction; 
DeletePortalDirectoryElementActi< 
PastePortalDirectoryElementActioi 

PortalDirectoryControllerFolderAction; 

PortalDirectoryControllerlnPlaceAction; 



import com. dcr .dvg .view. controller . portal . action. TogglePortalPreviewingAction; 



import com . dcr . dvg . view . controller .portal . action . ToggleShowAsPortalDbResultsAction; 

import com . dcr . dvg . view . controller . portal . action . PortalDirectoryControllerHelpAction; 
import com. dcr. dvg. view. controller .portal .action. PortalDirectoryExitAction; 
im.port com . dcr . dvg . view . controller . portal . exception . NoPortalSelectedExcept ion ; 
import com . dcr . dvg . view . controller . portal . exception .NoPortalFolderSelectedExcept ion ; 
import com . dcr . dvg . view . controller . portal . exception . UnableToAddPortalException; 
import com . dcr . dvg . view . controller . portal . exception . UnableToAddPortalFolderException; 
import 

com. dcr . dvg . view . controller . portal - exception . UnableToCopyPortalDirectoryElementExcepti 
import 

com . dcr . dvg . view . controller . portal . exception . UnableToCutPortalDirectoryElementExceptio 
import 

com. dcr . dvg . view . controller .portal . exception .UnableToDeletePortalDirectoryElementExcep 

tion; 

import 

com . dcr . dvg . view . controller . portal . exception . UnableToNewPortalDirectoryExcept ion; 
import 

com . dcr . dvg . view . controller . portal . exception .UnableToPastePortalDirectoryElementExcept 

import com . dcr . dvg . view . controller . portal . except ion . UnableToOpenPortalExcept ion ; 
import 

com. dcr . dvg .view. controller . portal .exception .UnableToOpenPortalDirectoryException; 
import 

com . dcr . dvg . view . control ler . portal . exception . UnableToSavePortalDirectoryException; 
import 

com . dcr . dvg .view . controller . portal . exception . UnableToSaveAsPortalDirectoryException; 

import com . dcr . dvg .view . controller . iteration . IterationControllerFrame ; 
import com . dcr . dvg . view . desktop . DVGDesktop Viewer ; 
import com . dcr . dvg . view . portal . PortalViewer ; 
import com . dcr . dvg . view . portal . PortalViewerFrame ; 

public class PortalDirectoryController extends DirectoryController { 

protected PortalDirectoryControllerFrame previewPortalFrame = null; 

protected boolean showAsDbRe suits = false; 
protected boolean previewingOf Portals = false; 

protected ExistingPortalFolderWizard exist ingPortalFolderPanel; 
protected NewPortalFolderWizard newPortalFolderPanel ; 
protected ExistingPortalWizard existingPortalPanel; 
protected NewPortalWizard newPortalPanel ; 

/** 

* Constructor, 
public PortalDirectoryController () { 
super 0 ; 

} 



/** 

* Constructor based on the desktopView. 

* <p> 

* Oparam desktopView - JLayeredPane 

public PortalDirectoryController (JLayeredPane desktopView) { 
super ( ) ; 

setDesktopView (desktopView) ; 
initialize () ; 

} 



* Present a dialog containing a new portal information panel. 

* <p> 

* @param action - PortalDirectoryControllerFolderAction - action to apply 
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public void actionAddPortal (PortalDirectoryControllerFolderAction action) { 
applyOperation (action) ; 

} 

/** 

* Add a new portal folder. 

* <p> 

* @param action - PortalDirectoryControllerFolderAction - action to apply 
public void actionAddPortalFolder (PortalDirectoryControllerFolderAction action) { 

applyOperation (action) ; 

} 

/** 

* Copy to the clipboard the selected Portal Directory Node Action. 

* <p> 

* oparam action - PortalDirectoryControllerFolderAction - action to apply 
*/ 

piiblic void actionCopyPortalDirectoryNode (PortalDirectoryControllerFolderAction 
applyOperation (action) ; 

} 



* Cut to the clipboard the selected Portal Directory Node Action. 

* <p> 

* ®param action - PortalDirectoryControllerFolderAction - action to apply 
*/ 

public void actionCutPortalDirectoryNode (PortalDirectoryControllerFolderAction action) 
{ 

applyOperation (action) ; 

} 

/** 

* Delete a portal node. 

* <p> 

* ©param action - PortalDirectoryControllerFolderAction - action to apply 
*/ 

public void actionDeletePortalDirectoryNode tPortalDirectoryControllerFolderAction 
action) { 

applyOperation (action) ; 

} 

/** 

* Edit a portal. 

* <p> 

* @param action - PortalDirectoryControllerlnPlaceAction - action to apply 
public void actionEditPortal (PortalDirectoryControllerlnPlaceAction action) { 

applyOperat ion ( act ion) ; 

} 

* Edit a portal folder . 

* <p> 

* ©paraiii action - PortalDirectoryControllerlnPlaceActron - action to apply 
public void actionEditPortalFoider (PortalDirectoryControllerlnPlaceAction action) { 

applyOperation (action) ; 

} 

/** 

* Get new portal directory. 

* <p> 

* @param action - PortalDirectoryControllerlnPlaceAction - action to apply 
*/ 

public void actiohNewPortalDirectory (PortalDirectoryControllerlnPlaceAction action) { 
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applyOperation (action) ; 

} 

* Open the portal selected in the portal directory viewer . 

* @param action - PortalDirectoryControllerlnPlaceAction - action to apply 
*/ 

public void actionOpenPortal (PortalDirectoryControllerlnPlaceAction action) { 
applyOperation (action) ; 

} 

* Open a "saved" portal directory. 

* <p> 

* (Sparam action - PortalDirectoryControllerlnPlaceAction - action to apply 
*/ 

public void actionOpenPortalDirectory CPortalDirectoryControllerlnPlaceAction action) 
applyOperation (action) ; 

} 

> the selected Portal Directory 

iram action - PortalDirectoryControllerFolderAction - action to apply 
; void actionPastePortalDirectoryNode (PortalDirectoryControllerFolderAction 



* Save As the portal directory. 

* <p> 

* dparam action - PortalDirectoryControllerlnPlaceAction - action to apply 
*/ 

public void actionSaveAsPortalDirectory (PortalDirectoryControllerlnPlaceActic 



* Save the portal directory. 

* <p> 

* ®param action - PortalDirectoryControllerlnPlaceAction - action to apply 
*/ 

public void actionSavePortalDirectory (PortalDirectoryControllerlnPlaceAction 
applyOperation (action) ; 

} 

/** 

* Save the portals . 
*/ 

public void actionTogglePreviewingOf Portals { ) { 

if (! getPreviewingOf Portals 0 ) { 

setPreviewingOf Portals (true) ; 

showPreviewPortalFrame ( ) ; 
} else { 

hidePreviewPortalFratne ( ) ; 

setPreviewingOf Portals (false) ; 

} 
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■ Save the portals. 
7 

iblic void actionToggleShowAsDbResults 0 



stShowAsDbResults (false) ; 



* Add a new portal folder. 

* <p> 

* @param folderNode - ITreeFolderNodeModel - not currently used 
public boolean addFolder (ITreeFolderNodeModel folderNode) { 

boolean completed = true; 

int selection = VCOptionDialog . showOptionDialog ( 

this, 
//parentComponent 

newPortalFolderPanel. update 0 , //message - object to 

display 

"New Portal Folder Information" , //title - title string for the 

^ VCOptionDialog. DEFAULT_OPTION, //optionType - 

YES_NO_OPTION or YES_NO_CANCEL_OPTION 

VCOptionDialog. QUESTION_MESSAGE, //messageType - ERROR_MESSAGE , 

INFORMATION MESSAGE, etc 

~ null, //icon - 

icon to display in the dialog 

AddElementOptionNames, //options - array of 

possible choices 

AddElementOptionNames [1] ) ; //initialValue - object 

that is the default selection 

if (selection == VCOptionDialog . OK_OPTION) { 
setVisible{true) ; 

newPortalFolderPanel. getEditorO . setFolder () ; 
newPortalFolderPanel -getEditorO .getFolderO . setOwner (MUserContext .getUserld ( ) ) 



PortalDirectoryFolderNodeModel (newPortalFolderPanel .getEditor () .getFolderO ) , 
getFolderNodeOf SelectedPortal () 

getPortalDirectory (> . invalidate () ; 
} catch (Exception exception) { 

f ireDbRe suit sExcept ion ( new 
UnableToAddPortalFolderException (exception) ) ; 

completed = false; 

} 

} else 

completed = false; 
return completed; 

} 

* Present a dialog containing a new portal information panel. 

* <p> 

* ©param folderNode - ITreeFolderNodeModel 

public boolean addTerminal (ITreeFolderNodeModel folderNode) { 
boolean completed = true; 

int selection = VCOptionDialog. showOptionDialog ( 
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this, 
/ /parent Component 

newPortalPanel.updateO , //message - object to 

display 

"New Portal Infomiation", //title - title string fo] 

the dialog 

VCOptionDialog.DEFAULT_OPTION, //optionType - 

YES_NO_OPTION or YES_NO_CANCEL_OPTION 

VCOptionDialog.QUESTION_MESSAGE, //messageType - ERROR_MESSAGE , 

INFORMATION_MESSAGE, etc 

null, //icon - 

icon to display in the dialog 

AddElementOptionNames, //options - array of 

possible choices 

AddElementOptionNames [1] ) ,- //initialValue - object 

that is the default selection 

if (selection == VCOptionDialog. OK_OPTION) { 
setvisible(true) ; 

newPortalPanel .getEditor ( ) . setModel ( ) ; 
try { 

getPortalDirectoryModel ( ) . insertNode ( 



) ; 

} catch (Exception exception) { 

f ireDbResultsException (new 
UnaibleToAddPortalException (exception) ) ; 

completed = false; 

^ ^ } 

completed = false; 
return completed; 

} 

/** 

* Clear the results viewer. DO NOTHING HERE 
*/ 

public void clearViewO { 
} 

/** 

* Add a directory element . 

* <p> 

* @param folderNode - ITreeFolderNodeModel - not currently used 
*/ 

public boolean copyNode ( ITreeFolderNodeModel folderNode) { 
boolean completed = true; 
try { 

getPortalDirectoryModel ( ) . copyToClipBoardNodeOf ( ( PortalDirectoryNodeModel ) getPo 
rtalDirectory ( ) .getSelectedNode { ) ) ; 

getPortalDirectory () . invalidate () ; 

f irePostStatus (getResourcesNameO , getResources ( ) , 
"PortalDirectoryElementCopied" ) ; 

} catch (Exception exception) { 

f ireDbResultsException (new 
UnableToCopyPortalDirectoryElementException (exception) ) ; 

completed = false; 



' Cut a directory element . 
= <p> 

' @param folderNode - ITreeFolderNodeModel - not currently used 
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public boolean cutNode (ITreeFolderNodeModel folderNode) { 
boolean completed = true; 



getPortalDirectoryModel () . cutToClipBoardtJodeOf ( (PortalDirectoryNodeModel) getPor 
talDirectory {) .getSelectedNode () ) ; 

getPortalDirectory () . invalidate () ; 

//will reset clipboard ==> updateViewO ; 

firePostStatus (getResourcesKaraeO , getResources ( ) , 
"PortalDirectoryEletnentCut" ) ; 

} catch (Exception exception) { 

f ireDbResultsException(new 
UnableToCutPortalDirectoryElementException (exception) ) ; 

completed = false; 

} 

return completed; 

} 

/** 

* Delete a directory element. 

* <p> 

* Oparam folderNode - ITreeFolderNodeModel - not currently used 
*/ 

public boolean deleteNode ( ITreeFolderNodeModel folderNode) { 
boolean completed = true; 
try { 

>veNode C (PortalDirectoryNodeModel) getPortalDirecto 

getPortalDirectory () . invalidateO ; 

UpdateViewO ; 
} catch (Exception exception) { 

f ireObResultsException (new 
UnableToDeletePortalDxrectoryElementException (exception) ) ; 
completed = false; 

} 

return completed; 

} 

* Disable the frame being used for previewing the database portal . 
*/ 

public void diablePreviewFrame ( ) { 
setPreviewPortalFrame (null) ; 

} 

* Edit a portal folder. 

* <p> 

* Oparam completed - boolean - true if successful 
*/ 

public boolean editFolderO { 

boolean completed = true; 

Object node = getPortalDirectory () .getSelectedPortalFolder () ; 

if (node instanceof PortalFolderModel) 

editPortalFolder ( (PortalFolderModel) node) ; 

else { 

f ireDbResultsException (new NoPortalFolderSelectedException () ) ; 
completed = false; 
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} 

return completed; 

} 

* Edit a portal. 

* <p> 

* @param completed - boolean - true if successful 
V 

public boolean editPortalO { 

boolean completed = true; 

Object node = getSelectedPortal () ; 

if (node instanceof PortalModel) 

editPortaK (PortalModel) node) ; 

else { 

f ireDbResultsException(new NoPortalSelectedException () ) ; 
completed = false; 

} 

return completed; 

} 

/** 

* Bring up a dialog containing a new portal information panel . 

* <p> 

* Oparam portal - PortalModel 
*/ 

public void editPortal (PortalModel portal) { 
notifyOperationBegun ( "Edit Portal") ; 

int selection = VCOptionDialog . showOptionDialog ( 
this, 

//parent Component 

existingPortalPanel.update (portal) , //message - object to display 
"Edit Portal Information", //title - title string for 

the dialog 

VCOptionDialog. DEFAULT_OPTI ON, //optionType - 

YES_NO_OPTION or YES_NO_CAlICEL_OPTION 

VCOptionDialog. QUESTION_MESSAGE, //messageType - ERROR_MESSAGE, 

INFORMATION MESSAGE, etc 

" null, //icon - 

icon to display in the dialog 

EditEleraentOptionHaraes, //options - array 

of possible choices 

EditElementOptionNames [1] ) ; //initialValue - object 

that is the default selection 

if (selection == VCOptionDialog. OK_OPTION) { 
setvisible{true) ; 

existingPortalPanel .getEditor ( ) .setModelO ; 

notifyOperationFinished("Edit Portal") ; 

notifyOperationCanceled{ "Edit Portal") ; 

if(i this.isVisibleO ) 

//DV was shut down before completion of this action 
System. exit (0) ; 

} 

} 

/** 

* Bring up a dialog containing a new portal information panel. 

* <p> 

* @param portalFolder - PortalFolderModel 
*/ 

public void editPortalFolder (PortalFolderModel portalFolder) { 
notifyOperationBegun ("Edit Portal Folder"); 
int selection = VCOptionDialog. showOptionDialog ( 
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this, 
/ /parentComponent 

existingPortalFolderPanel .update (portalFolder) , //message - object to 

display 

"Edit Portal Information", //title - title string for 

the dialog 

VCOptionDialog.DEFAULT_OPTIOH, //optionType - 

YES_HO_OPTION or YES_NO_CANCEL_OPTION 

VCOptionDialog.QUESTION_MESSAGE, //messageType - ERROR_iyiESSAGE , 

INFORMATION_MESSAGE, etc 

null, //icon - 

icon to display in the dialog 

EditElementOptionNames, //options - array 

of possible choices 

EditElementOptionNames [1] ) ; //initialValue - object 

that is the default selection 

if (selection == VCOptionDialog . OK_OPTION) { 
setvisible (true) ; 

existingPortalFolderPanel .getEditor ( ) .setFolderO ; 

notifyOperationFinished ( "Edit Portal Folder"); 
} else { 

notifyOperationCanceled("Edit Portal Folder"); 

if(! this.isVisibleO ) 

//DV was shut down before completion of this action 
System. exit (0) ; 



5 supported by this launcher. 

_ons supported by the embedded JTextComponent 
augmented with the actions defined locally. 



n[] default Act ions = { 
ew EditPortalFolderActic 
ew AddPortalFolderActioi 



17 OpenPortalActic 



w NewPortalDirectoryAction (this) , 
w OpenPortalDirecrtoryAction (this) , 
w SavePortalDirectoryActionCthis) , 
w SaveAsPortalDirectoryAction (this) , 

new CopyPortalDirectoryElementAction 
new CutPortalDirectoryElementAction (t 
new PastePortalDirectoryElementActioi 
new DeletePortalDirectoryElementActic 



I PortalDirectoryControllerHelpActic 
I PortalDirectoryExitAction(this) , 



L . augmentList ( super . get Act ions () , defaultActi< 



} 

/** 

* Gets the Explorer Directory view. 

* <p> 

* ©return explorerDirectory ExplorerDirectory 
*/ 

piiblic ExplorerDirectory getExplorerDirectory () 
1 getPortalDirectory ( ) ; 
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} 



/* 

* Gets the folder node that owns this Portal . 

* <p> 

* ©return folderModel - PortalDirectoryFolderNodeModel 
*/ 

public PortalDirectoryFolderNodeModel getFolderNodeOf SelectedPortal ( ) { 



(PortalDirectoryFolderNodeModel) getPortalDirectoryO . getFolderNodeOf SelectedPortal ( ) ; 
} 



/** 

* Gets the type name of the node (e.g., Portal, Data Source) managed by the 
controller. 

* <p> 

* ©return nodeTypeName String 
*/ 

public String getNodeTypeName { ) { 

} ^"""^^^ ' 

/** 

* Gets the exception for "no folder selected" . 

* <p> 

* ©return exception - DVException 

public DVException getNoFolderSelectedException{ ) { 
return new NoPortalFolderSelectedException ( ) ; 

} 



/** 

* Gets the portal diretory. 

* <p> 

* ©return portalDirectory - PortalDirectory 
*/ 

public PortalDirectory getPortalDirectoryO { 

return { (PortalDirectoryView) getview ( ) ) .getPortalDirectoryO ; 

} 



/** 

* Gets the portal tree. 

* <p> 

* ©return portalTree PortalDirectoryModel 
*/ 

public PortalDirectoryModel getPortalDirectoryModel ( ) { 

return (PortalDirectoryModel)getPortalDirectory 0 .getModelO; 

} 



* Answer if portals are to be previewed. 

* <p> 

* ©return previewingOf Portals - boolean 
*/ 

public boolean getPreviewingOf Portals { ) { 
return previewingOf Portals ; 

} 



/** 

* Gets the preview portal frame . 

* <p> 

* ®param previewPortal Frame - PortalDirectoryControllerFrame 
*/ 

public PortalDirectoryControllerFrame getPreviewPortalFrame O { 
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if (previewPortalFrame == null) 

setPreviewPortalFrame (queNewDbResultsViewerFraraeO ) ; 

return previewPortalFrame; 

} 



/** 

* Gets the selected portal from the portals tree. 

* <p> 

* ©param selectedPortal - PortalModel - returns null if no portal is selected 
*/ 

public PortalModel getSelectedPortal { ) { 
Object node = null; 
try { 

node = getPortalDirectoryO .getSelectedPortal 0 ; 
} catch (Exception exception) { 
} 

return { Port alMode 1 ) node ; 

} 



* Answer if the portal is to be shown as DB Results 

* <p> 

* ©return showAsDbResults - boolean 
*/ 

public boolean getShowAsDbResults { ) { 
return showAsDbResults; 

} 



/** 

* Gets the Tree Directory Model . 

* <p> 

* ©return portalDirectoryModel - TreeDirectoryModel 
*/ 

piiblic TreeDirectoryModel getTreeDirectoryModel ( ) { 
return getPortalDirectoryModel ( ) ; 

} 



* Hide the preview portal frame . 
*/ 

public void hidePreviewPortalFrame () { 

removePropertyChangeListener (getPreviewPortalFrame {) ) ; 
getPreviewPortalFrame () . setvisible (false) ; 

} 



/** 

* Creates the command line content area. 

* <p> 

* ©return success boolean 
*/ 

public boolean initialize () { 

initialize ( "PortalDirectoryController" , (IVPView)new PortalDirectoryView { ) ) ; 

getPortalDirectoryO . addTreeSelectionListener (new 
PortalDirectorySelectionListener (this) ) ; 

getPortalDirectoryO .expandRow(l) ; 

existingPortalFolderPanel = new ExistingPortalFolderWizard (this) ; 
newPortalFolderPanel = new NewPortalFolderWizard (this) ; 
existingPortalPanel = new ExistingPortalWizard(this) ; 
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newPortalPanel = new NewPortalWizard (this) ; 

//DONE LATER setPreviewPortalFrame (queNewDbResultsViewerFrame { ) > ; 



* Launches the help facility for this 
*/ 

public void launchViewerContextHelp ( ) { 

launchViewerContextHelpUsing ( "portalDirectoryController " ) ; 

} 

* Sets a new portal directory. 

* <p> 

* ©parara completed - boolean - true if successful 
*/ 

public boolean newPortalDirectory ( ) { 
boolean completed = true; 
try { 

PortalDirectoryModel .getSessionModel () . setNewModel < ) ; 
} catch (Exception exception) { 

f ireDbRe sultsException(new 
UnableToNewPortalDirectoryException (exception) ) ; 
completed = false; 

} 

return completed; 

} 

/** 

* Open a "saved" portal directory. 

* <p> 

* @param completed - boolean - true 
*/ 

public boolean openDirectory ( ) { 
boolean completed = true; 
File file = getFileToOpen { ) ; 
try { 



updateViewO ; 

} 

} catch (Exception exception) { 

f ireDbResultsException (new 
UnableToOpenPortalDirectoryException (exception) ) ; 
completed = false; 

} 

return completed; 

} 

* Opens the portal selected in the portal directory 

* <p> 

* (Sparam completed - boolean - true if successful 
*/ 

public boolean openPortal () { 

boolean completed = true; 
Object node = null; 
try { 

node = getPortalDirectory 0 -getSelectedPortal () ; 



} catch (Exception exception) { 
} 

traceMessage("\n" + getClassO + " » openPortalO on node:" + node) ; 

PortalViewer portalviewer = null; 

if (node instanceof PortalModel) 

portalviewer = openPortal ( (PortalModel ) node) ; 

else { 

clearViewO ; 

f ireDbResultsException{new NoPortalSelectedException ( ) ) ; 
completed = false; 

} 

return completed; 

} 

/** 

* Opens the specified portal. 

* <p> 

* (gparam portalModel - PortalModel - portal to open 
*/ 

public Portalviewer openPortal (PortalModel portalModel) { 

f irePostStatus ( 

getResourcesName () , 
getResources () , 
"OpeningPortal" , 

" \ " " + portalModel . getName ( ) + " \ " . " 



PortalViewerFrame portalFrame = getDesktopViewer () .getNewPortalFrame () ; 
// portalFrame . f ireExecuteCoramands (/*cOTnmandText*/" " ) ; 

portalFrame . refresh ( ) ; 

portalFrame . viewPortal (portalModel) ; 
portalFrame . setVisible (true) ; 

f irePostStatus ( 

"\"" + portalModel . getName ( ) + "\" 
getResourcesName () , 
getResources {) , 
"PortalOpened" 



return portalFrame . getPortalViewer ( ) ; 

} 



* Pastes a Directory Node . 

* <p> 

* Oparam completed - boolean - true if successful 
*/ 

public boolean pasteNode (ITreeFolderNodeModel folderNode) { 
boolean completed = true; 
try { 

getPortalDirectoryModel { ) 

. pasteClipBoardNodeTo ( { PortalDirectoryFolderNodeModel) getPortalDirectory ( ) . getFolderNo 
deOf SelectedPortal {) ) ; 

getPortalDirectory () . invalidate ( ) ; 
} catch (Exception exception) { 

f ireDbResultsException (new 
UnableToPastePortalDirectoryElementExcept ion (exception) ) ; 
completed = false; 

} 

return completed; 

} 

* Que a new DbResultsViewer frame that will be added to the desktop later. 
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* ©param resultsViewerFrame PortalDirectoryControllerFrame 
*/ 

public PortalDirectoryControllerFrame queNewDbResultsViewerFrame { ) { 
// frame is added to the desktop later 

PortalDirectoryControllerFrame resultsViewerFrame = new 
PortalDirectoryControllerFrame CgetDesktopViewO , getNewFrameDiraension ( ) ) ; 

( (DVGDesktop)getDesktopView() ) . setNextDbResultsPrameCount ( ) ; 

resultsViewerFrame. setFrameId( ( (DVGDesktop) getDesktopView ( ) ) .getObResultsFrameC 
addPropertyChangeliistener (resultsViewerFrame) ; 

resultsViewerFrame. addPropertyChangeListener(getIterationControllerFrame () ) ; 
return resultsViewerFrame; 

} 

* Save As the portal directory. 

* <p> 

* (Sparam completed - boolean - true if successful 
*/ 

piiblic boolean saveAsDirectory () { 
boolean completed = true; 
File file = getFileToSave () ; 
try { 

if (file 1= null) 

PortalDirectoryModel .getSessionModel ( ) . saveAs (f ile) ; 
} catch (Exception exception) { 

f ireDbResultsException (new 
UnableToSaveAsPortalDirectoryException (exception) ) ; 
completed = false; 

} 

return completed; 

} 



/** 

* Saves the portal directory. 

* <p> 

* @param completed - boolean - true if successful 
*/ 

public boolean saveDirectory ( ) { 
boolean completed = true; 
try { 

PortalDirectoryModel .getSessionModel ( ) .saveO ; 
} catch (Exception exception) { 

f ireDbResultsException (new 
UnableToSavePortalDirectoryException (exception) ) ; 
completed = false; 

} 

return completed; 

} 

* Sets if portals are to be previewed. 

* <p> 

* ©param mode - boolean 
*/ 

public void setPreviewingOf Portals (boolean mode) { 
previewingOf Portals = mode; 

} 

* Sets the frame to be used for previewing the portal. 

* <p> 

* ®param previewPortalFrame - PortalDirectoryControllerFrame 
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public void setPreviewPortalFrame { PortalDirectoryControllerFrame previewPortal Frame) { 

if (previewPortalFrame != null) 

removePropertyCliangeListener (previewPortalFrame) ; 

this .previewPortalFrame = previewPortalFrame ; 

// PropertyChangeListener added upon showing of preview 

} 



/** 

* Sets if the portal is to be shown as DB Results. 

* <p> 

* (gparam mode - boolean 
*/ 

public void setShowAsDbResults (boolean mode) { 
showAsDbRe suits = mode; 

} 



* Show the preview portal frame. 
*/ 

public void showPreviewPortalFrame ( ) { 

addPropertyChangeListener (getPreviewPortalFrame () ) ; 
getPreviewPortalFrame () . setvisible (true) ; 

} 



/** 

* Update the portal directory view. 
*/ 

public void updateViewO { 

( (PortalDirectoryView)getView() ) . getPortalDirectory ( ) .updateViewO ; 

} 

/** 

* Previews the database of the database portal. 

* <p> 

* ®param portal - PortalModel - the database portal to preview 
*/ 

public void viewDataBasePortal (PortalModel portal) { 

traceMessage(getClass() + " >> viewDataBasePortal"); 

f ireClearDesktopStatus () ; 

if (getPreviewingOf Portals ( ) ) ( 

if (! getShowAsDbResults 0 ) { 

// just reuse exiting preview frame and preview listener 
firePropertyChange{ "Portal Available", null, portal); 
} else { 

//do not reuse preview frame plus getPreviewingOf Portals ( ) 

state does not matter 

diablePreviewFrame ( ) ; 
queNewDbResultsViewerFrame ( ) ; 

firePropertyChange( "Portal Available", null, portal); 

} 

} 

} 
) 

/** 

* @ (#) PortalDirectoryView. java 

* <p> 




* <p> 

* The <code>PortalDirectoryView</code> is a parent view of 
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* a <code>Portal Directory<code> . 

* <p> 

* ©author Edward L . Stull 

* ©since JDK 2 

//345678 901234 56789012345578901234567890123456789*12345678! 
import j avax . swing . SwingConstants ; 



45678901234567890 



import ( 
import < 
import ( 

import ( 
import { 



i.dcr.dve.\ 



1 . vcomponent . VCBorderLayout ; 
/ . vcomponent . vcpanel . VCLayout ; 
J. vprocess . IVPView; 



1 . dcr . dvg .model . portal . directory . Port alDirectoryFolderNodeModel ; 
\ . dcr . dvg .model . portal . directory . Port alDirectoryModel ; 
1 . dcr . dvg . view . component . panel . DVGPanel ; 



piiblic class PortalDirectoryView 
extends DVGPanel 
implements IVPView { 

protected PortalDirectory portalDirectory; 



package com. dcr . dvg .view. controller .portal ; 
/** 

* @{#) PortalEditor. java 



* The <code>PortalEditor</code> class is the editor viev 

* <p> 

* ©author Edward L. Stull 

* ©version 1.9 

* ©since JDKl.l 
*/ 

//34SS78 901234 5678901234 56 7890123456 789 012 345 678 9*123456- 



I Portal Model. 



10123456789012345S7890 



import j a' 

import j a- 

import j a 

import j a 

import coi 

import coi 

import coi 

import coi 

import COI 

import COI 

import COI 

import coi 

import coi 

import COI 



-a.util .Date; 

'a . ut il . Enumerat i^ 

-a.util .Vector; 

i.klg.jclas 



il . swing . JCAl ignLayout ; 



model . mdb . MDbDrivers ; 

view . vcomponent . VCBoxLayout ; 

view . vcomponent . VCColor ; 

view . vcomponent . VCGr idLayout ; 

view . vcomponent . vcgraphic . VCGraphic ; 

view . vcomponent . vcwizard . VCWizardStep ; 

view . vmode 1 . VMPas sword ; 

view. vprocess . VPWizardComboBox; 

view . vprocess . VPWizardField; 

view . vprocess . VPWizardGroupBox ; 

view . vprocess . VPWizardLabel ; 

view, vprocess .VPWizardReadOnlyField; 



dcr . dve 

dcr . dve 
dcr . dve 

dcr . dve 
dcr . dvg 
dcr . dve 
dcr. dve 

dcr . dve 
dcr. dve 



1 .portal .directory . PortalModel ; 
dcr . dvg . model . portal . directory . PortalDirectoryFolderNodeModel ; 
.ew . component . panel . DVGPanel ; 



: class PortalEditor extends DVGPanel { 



■ controller = null; 



lull ; 

protected VPWizardField hostFolderNameField; 
protected VPWizardField portalNameField; 
protected VPWizardField lastUpdatedDateField; 
protected VPWizardField portalOwnerNaraeField; 
protected VPWizardField userldField; 
protected VMPassword passwordField; 



protected VPWizardField serverField; 
protected VPWizardComboBox driverField; 
protected VPWizardComboBox accessModeField; 

protected VPWizardField tableQueryField; 
protected VPWizardField metaQueryField; 
protected VPWizardField chartQueryField ; 
protected VPWizardField plexusQueryField; 
protected VPWizardField testSetSamplingQueryField; 

/** 

* Constructor based on the host view. 

* <p> 

* @param controller - PortalDirectoryController 
*/ 

public PortalEditor (PortalDirectoryController controller) { 
this . controller = controller; 



/** 

* Gets the controller . 

* <p> 

* ©return controller - PortalDirectoryController 
*/ 

public PortalDirectoryController getController () { 
return controller; 

} 



/* 

* Gets the folder that owns this portal. 

* ©return folder - PortalDirectoryFolderNodeModel 
*/ 

piiblic PortalDirectoryFolderNodeModel getFolderO { 

return getController ( ) .getFolderNodeOf SelectedPortal () ; 

} 

/* 

* Gets the portal being, edited. 

* <p> 

* ©return portal - PortalModel 
V 

public PortalModel getPortalO { 
return portal ; 

} 



/** 
*/ 

public void initialize {) { 

setLayout {new JCAlignLayout (2 , 5, 5)); 

add (new VPWizardLabel ( "Host Folder:")); 
add (host FolderNaraeField = new 
VPWizardReadOnlyField(PortalModel .getOvmerDefault () ) ) ; 

add (new VPWizardLabel ( "Name : " ) ) ; 

add(portalNameField = new VPWizardField (PortalModel .getNameDefault ())) ; 
add (new VPWizardLabel ( "Last Updated Date:")); 

adddastUpdatedDateField = new VPWizardField (PortalModel .getDateDefault ())) ; 
add (new VPWizardLabel ( "Owner : " ) ) ; 

add(portalOwnerNameField = new VPWizardField (PortalModel .getOwnerDefault {))) ; 
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add (new VPWizardLabel ( "User Id : " ) ) ,- 

add (user IdField = new VPWizardField (PortalModel .getUserldDef ault ( ) ) ) ; 



/* 

* Sets the portal's model. 

* <p> 

* ©return portal - PortalModel 
*/ 

public PortalModel setModelO { 

PortalModel portal = getPortal () ; 

portal. setDate (new DateO .toStringO ) ; 
portal . setName (portalNameField . getText ( ) ) ; 
portal . setOwner (portalOwnerNameField . getText ( ) ) ; 



* Updates the editor with the default portal state. 

* <p> 

* ©return portalEditor - PortalEditor - editor used to return an updated obje^ 
the dialog 

V 

public PortalEditor update () { 

this. portal = new PortalModel () ; 

hostFolderNameField. setTeraplateText (getFolder () .getName () ) ; 
portalNameField. setTemplateText (PortalModel .getNameDef ault () ) ; 
lastUpdatedDateField. setTemplateText (PortalModel .getDateDef ault () > ,- 
portalOwnerNameField. setTemplateText (PortalModel . get OwnerDef ault () ) ; 
userldField. setTemplateText (PortalModel . getUserldDef ault ( ) ) ; 
passwordField. setTemplateText (PortalModel . getUserPasswordDef ault {) ) ; 

return this; 



; the editor with the portal state. 

■ PortalEditor - editor used to return an updated object to 

ptiblic PortalEditor update (PortalModel portalToBeEdited) ( 
this. portal = portalToBeEdited, - 

hostFolderNameField. setTemplateText (getFolder 0 .getNameO ) ; 
lastUpdatedDateField . setTemplateText (portal . getDate ( ) ) ; 
portalNameField . setTemplateText (portal . getName ( ) ) ; 
portalOwnerNameField. setTemplateText (portal. getOwnerO ) ; 

return this; 

} 
} 

package com. dcr . dvg . view . controller . portal ; 
* @ (#) Portal Fol derEdit or . j ava 



i the editor view of 



Edward L. 
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* ©since JDKl . 1 

*/ 

//3456789012345678901234567890123 



56789012345678! 



:7890123456789012345678 



import com, 
import com. 

import com, 
import com, 
import com. 
import com. 
import com 

import com . c 
import I 



3 s . ut i 1 . swing . JCAl ignLayout ; 

7iew . vcomponent . VCBoxLayout ; 
dcr . dve . view . vcomponent . VCColor ; 
dcr . dve . view . vcomponent . VCGr idLayout ; 
dcr . dve . view . vcomponent . vcgraphic . VCGraphic ; 
dcr . dve . view . vcomponent . vcwizard . VCWizardStep ; 
dcr .dve . view. vprocess.VPWizardField; 
dcr . dve . view . vproces s . VPWi zardLabel ; 
dcr .dve .view. vproces s -VPWi zardReadOnlyField; 



} . model . portal . directory . PortalFolderModel ; 
J. model .portal . directory . Port alDirectoryFolderNodeModel; 
view . component . panel . DVGPanel ; 

1 PortalFolderEditor extends DVGPanel { 



protected PortalDirectoryController controller = null; 
protected PortalFolderModel folder = null; 

protected VPWizardField liostFolderHaraeField; 
protected VPWizardField portalNameField; 
protected VPWizardField lastUpdatedDateField; 
protected VPWizardField portalOwnerNameField; 

/** 

* Constructor based on the host view. 

* <p> 

* (Sparam controller - PortalDirectoryController 
*/ 

public PortalFolderEditor (PortalDirectoryController controlle: 
this .controller = controller; 
initialize ( ) ; 

} 



* Gets the controller . 

* <p> 

* ©return controller - PortalDirectoryController 
*/ 

public PortalDirectoryController getController ( ) 
1 controller; 



/* 

* Gets the folder being edited. 

* <p> 

* ©return folder - PortalFolderModel 
*/ 

public PortalFolderModel getFolderO { 
return folder; 



* Gets the folder that owns this portal. 

* <p> 

* ©return folder - PortalFolderModel 
*/ 

public PortalFolderModel getHostFolder ( ) ' 



( (PortalDirectoryFolderNodeModel) getHostFolderTreeNode () ) .getPortalFolder () 



/* 

* Gets the folder directory node that owns this portal. 

* <p> 

* ©return folder - PortalDirectoryFolderNodeModel 
V 

public PortalDirectoryFolderNodeModel getHostPolderTreeNode ( ) 

return getController ( ) . getFolderNodeOf SelectedPortal { ) ; 

} 

/* 

* Gets the folder directory node that owns this portal. 

* <p> 

* ©return folder - PortalDirectoryFolderNodeModel 
public PortalDirectoryFolderNodeModel getTreeNode ( ) { 

return getController { ) . getFolderNodeOf SelectedPortaK ) , 

} 

/** 

* Initializes . 
*/ 

public void initialize () { 

setLayout (new JCAlignLayout (2, 5, 5) ) ; 

add (new VPWi zardLabel ( "Host Folder : " ) ) ; 
add(hostFolderNameField = new 
VPWizardReadOnlyField(PortalFolderModel .getOwnerDefault ( ) ) ) ; 



add (new VPWizardLabel ( "Last Updated Date:")); 
adddastUpdatedOateField = new 
VPWizardField ( PortalFolderModel .getLastUpdatedDateDef ault { ) ) ) ; 

add (new VPWizardLabel ("Owner: " ) ) ; 
add(portalOwnerNameField = new 
VPWizardField (PortalFolderModel. getOwnerDefault 0 ) ) ; 



/* 

* Sets the state of the portal folder model . 

* <p> 

* ©return folder - PortalFolderModel 
*/ 

p-ublic PortalFolderModel setFolderO { 

getFolder ( ) . setDate (new Date ( ) . toString ( ) ) ; 
getFolder ( ) . setName (portalNameField . getText ( ) ) ,- 
getFolder () . setOwner (portalOwnerNameField .getText () ) ,- 

return getFolder ( ) ; 

} 



/** 

* Updates the editor with the default portal state. 

* <p> 

* ©return portalEditor - PortalEditor - editor used to return an updated object to 
the dialog */ 

public Portal FolderEditor update () { 

this . folder = new PortalFolderModel { ) ; 

hostFolderNameField.setTemplateText{getHostFolder() .getNameO ) ; 
portalNameField. setTemplateText { PortalFolderModel. getNameDef ault () ) ; 
lastUpdatedDateField. setTemplateText (PortalFolderModel . getLastUpdatedDateDef aul 

tO) ; 

portalOwnerNameField. setTemplateText (PortalFolderModel .getOwnerDefault () ) ; 
return this; 
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■ Updates the editor with the portal state. 
' <p> 

' (Sreturn portalEditor - PortalEditor - editor i 



sad t 



I updated obje' 



the dialog 

public PortalFolderEditor update (PortalFolderModel f olderToBeEdited) { 
this. folder = f olderToBeEdited; 

hostFolderNaraeField. setTemplateText (getHostFolder ( ) .getName () ) ; 
lastUpdatedDateField.setTemplateText (folderToBeEdited.getLastUpdatedDateO ) ; 
portalNameField. setTemplateText (f OlderToBeEdited. getName 0 ) ; 
portalOwnerNameField . setTemplateText ( f olderToBeEdited . getOwner ( ) ) ; 

return this ; 



package com.dcr .dvg.-^ 
* @(#)PortalViewer.; 



* The <code>PortalViewer</code> displays and manages the viewers of a portal. 

* <p> 

* ©author Edward L. Stull 

* ©version 2 .133 

* ©since JDK 2 
*/ 

//3455789012345S789012345S78901234567890123456789*123456789012345678901234567890 

import j ava . awt . Cursor ; 
import java.awt-FileDialog; 
import j ava . awt . Frame ; 

import j ava . beans . PropertyChangeEvent ; 
import java.io.File; 
import j ava . io . FilelnputStream; 
import java.io.IOException; 
import j ava . io . Ob j ectlnputStreara; 
.mport Java. util . Enumeration; 
import j ava. util .Vector; 

import javax. swing. Act ion; 

import j avax . swing'. JIntemalFrame ; 

import j avax. swing. JLayeredPane; 

import j avax . swing . event . InternalFrameEvent ; 

import j avax . swing . event . InternalFrameListener ; 

import j avax . swing . text . TextAction; 

import j avax . swing . t ree . TreeModel ; 



import c 
import c 
import c 

import c 
import c 
import c 

import c 
import < 
import < 

import ( 

import < 
import ( 



1. dcr .dve .model .mdb .MDbJCDataEvent ; 

X. dcr .dve .model .mdb . MDbDataModelListener; 

1 . dcr . dve . model . mdb . MDbMetaDataModel ; 

1 . dcr . dve . model . mdb . MDbNodePr opert ies ; 

1. dcr .dve .model .mdb . MDbNodeTreeData ; 

1. dcr -dve. model .mdb .MDbTreeProperties; 

n . dcr . dve . view . vcomponent . VCBorderLayout ; 

:i. dcr. dve .view. vcomponent .vccontrol . VCControlBar; 

1 . dcr . dve . view . vcomponent . vclabel . VCLabel ; 

a . dcr . dve . view . vcomponent . vet ext . VCRichText Paragraph ; 

n . dcr . dve .view . vcomponent . vctablerecord . VCTrRecord ; 

a. dcr .dve . view . vcomponent . vcplexus . VCPlexus; 

a . dcr . dve .view . vprocess . vphigrid . VPHDesktopHiGridViewerFrame ; 
(t . dcr . dve . view . vproces s . vphigrid . VPVHiGr idExternalDS ; 

a. dcr .dvg. model .MessageKit; 

K . dcr . dvg . model . TransientChangeOwnerModel ; 

ft. dcr .dvg. model .portal . directory. PortalModel ; 

n. dcr .dvg. model . session. SessionModel ; 

a . dcr . dvg .model . viewer . ViewerModel ; 

n . dcr . dvg .model . viewer . DataSourceViewerModel ; 
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. MViewerChart ; 


import CO 


Ti cr 




model .viewer 


. MViewerCrystalReport s ; 


import CO 


Ti.dcr 


dvg 


model .viewer 


. MViewerHiGrid ; 


import CO 


n.dcr 


dvg 


model . viewer . MViewerPlexus ; 


import CO 


Ti cr 




model . viewer 


. MViewerRecord ; 


import CO 


-a cr 


d^^ 




. MViewerSgl ; 


impor CO 


1. cr 




model .viewer .MViewerMeta; 


impor CO 


1- cr 


d^^ 






component . desktop . DVGDesktop ; 


impor CO 




d^^ 


v; 


ew 


component . desktop . DVGInternalFrame; 




I'dcr 


d^^ 


v; 




controller .datasource .DataSourceDirectory; 


import CO 


I'dcr 


dv^ 






controller . datasource . DataSourceDirectoryControllerFrame ; 


import CO 


^I'dcr 


dv| 






controller .transcript .TranscriptControllerFrame; 


import CO 


rn.dcr 


dvg 


VI 




desktop . DVGDesktopViewer ; 


import CO 


m.dcr 


dvg 






dsproj ection . InternalResultsViewer ; 


import CO 


m.dcr 


dvg 


VI 




dspro j e 


ction. crystalreports . CrystalReportsViewerFrame; 


import CO 


m.dcr 


dvg 






dsproj e 


ct ion. record. RecordResult sViewerFrame, • 


import CO 


[ti.dcr 


dvg 


VI 




dsproj 6 


ction. sql . SqlResult sViewerFrame; 


import CO 


m.dcr 


dvg 






dsproj act ion . meta . MetaViewer Frame ; 










ew 




PortalViewerFrame ; 


import CO 


m.dcr 


dvg 








action. Copy PortalContentsAct ion, - 


import CO 


m.dcr 


dvg 




ew 




action . Exit PortalViewerAct ion ; 


import CO 


m.dcr 


dvg 


V3 


ew 




action. PortalViewerHelpAction; 


import CO 


ti.dcr 










ac t ion . NewChartViewer Ac t ion ; 


import CO 


rei. cr 






ew 




act ion . NewCrys talReport sViewerAct ion ; 


import CO 




d^^ 








action.NewHiGridViewerAction; 




ndcr 


dvg 








act ion . NewMetaViewerAct ion ; 


import CO 


m!dcr 


dvg 








action.WewPlexusViewerAction; 


import CO 


m.dcr 


dvg 








ac t ion . Ne wR e CO rdV iewe r Ac t i on ; 


import CO 


m.dcr 


dvg 








ac t ion . NewSqlRe suit sViewerAct i on ; 


import CO 


m.dcr 


dvg 








action . PortalViewerHelpAction , • 


import CO 


m.dcr 


dvg 








act ion . Ref reshPortalViewerAction ; 


import CO 


m.dcr 


dvg 








action . SavePortalViewerAction; 


import CO 


m.dcr 


dvg 








action . SaveAsPortalViewerAction; 


import CO 


m.dcr 


dvg 








action . ToggleShowSglViewerAction ; 


import CO 


dcr 








desktop . VPDesktopViewer ; 




m.dcr 


dvg 






dsproj ection . DataSourceViewerFrame ; 




m.dcr 








dsproj ection. chart . Chart Re suit sViewer Frame ; 


import CO 




dvg 






dsproj ection. plexus . PlexusResultsViewerFrame; 


import CO 








il 


throwable.DataSourceCouldNotBeOpenedException; 


import CO 








il 


throwable . DVError ; 


import CO 


m.dcr 






-il 


throwable . DVExcept ion ; 


import CO 








il 


throwable . FileBeingOpenedDoesNotExistException; 




m.dcr 




u 


-il 


throwable. NoDataSourceSelectedForQueryExecutionException; 



public class PortalViewer extends VPDesktopViewer implements IntemalFrameListener { 

protected PortalModel portalModel = null; 

protected PortalViewerFrame viewerController = null; 

protected ChartResultsViewerFrarae chartViewerFrame = null; 
protected VPHDesktopHiGridViewerFrame tableViewerFrame = null; 

/** 

* Constructor based on the viewer frame . 

* <p> 

* ©param viewerController - PortalViewerFrame 
*/ 

public PortalViewer (PortalViewerFrame viewerController) { 
super { ) ; 

this .viewerController = viewerController; 

} 



* Adds a new external viewer. 

* <p> 

* @param viewerModel - ViewerModel 

* Oparam frame - DataSourceViewerFrame 

* ©param dataSource - MDbNodeTreeData 
*/ 
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public void addNewExternalViewer (ViewerModel v i ewer Mode 1 , DataSourceViewerFrame frame, 
MDbNodeTreeData dataSource) { 

showExternalViewer (viewerModel, frame, dataSource); 

} 

/** 

* Adds a new internal viewer. 

* <p> 

* ®param viewerModel - DataSourceViewerModel 

* ®param viewerFrame - DataSourceViewerFrame 

* ®param dataSource - MDbNodeTreeData 
*/ 

public void adduewlnternalviewer (DataSourceViewerModel viewerModel, 
DataSourceViewerFrame viewerFrame, MDbNodeTreeData dataSource) 
throws DVException { 

MDbNodeTreeData targetTreeDataSource = dataSource; 
if (targetTreeDataSource == null) { 

MDbNodeTreeData viewerModelDataSource = 
( (DataSourceViewerModel) viewerModel) . getOat aModel () ; 

if (viewerModelDataSource != null && viewerModelDataSource . isReady () ) 
targetTreeDataSource = viewerModelDataSource; 

else 

targetTreeDataSource = 
(MDbNodeTreeData) getSelectedDataSourceO . clone () ; 
} 

if (targetTreeDataSource != null) { 

getPortalModel 0 .addviewer ( { (DataSourceViewerModel) viewerModel) ) ; 

viewerModel . setDataModelNoNotif y ( (MDbNodeTreeData) targetTreeDataSource) ; 

showDbViewer ( ( (DataSourceViewerModel) viewerModel) , viewerFrame, 
targetTreeDataSource) ; 
} else 

fireDbResultsViewerException(new 
NoDataSourceSelectedForQueryExecutionExceptionO ) ; 
} 

/** 

* Adds a new viewer. 

* <p> 

* Oparam viewerModel - DataSourceViewerModel 
public void addNewViewer (ViewerModel viewerModel) { 

DataSourceViewerFrame frame = null; 

PortalViewerFrame viewerController = (PortalViewerFrame) getViewerController ( ) ; 
JLayeredPane desktopView = getDesktopView ( ) ; 

if (viewerModel instanceof MViewerHiGrid) 

frame = new VPHDesktopHiGridViewerFrame (viewerController, desktopView); 
else if (viewerModel instanceof MViewerChart) 

frame = new ChartResultsViewerFrame (viewerController, desktopView); 
else if (viewerModel instanceof MViewerPlexus ) 

frame = new PlexusResultsViewerFrame (viewerController, desktopView) ; 
else if (viewerModel instanceof MViewerRecord) 

frame = new RecordResultsViewerFrame (viewerController, desktopView); 
else if (viewerModel instanceof MViewerCrystalReports) 

frame = new CrystalReportsViewerFrame (viewerController , 
getDesktopView () ) ; 

else if (viewerModel instanceof MViewerSql) 

frame = new SqlResultsViewerFrame (viewerController , getDesktopView ()) ; 
else if (viewerModel instanceof MViewerMeta) 

frame = new MetaViewerFrame (viewerController, getDesktopView ()) ; 

addNewViewerOperation (viewerModel, frame, null); 

} 

* Adds a new viewer (basic operation) . 

* <p> 

* @param viewerModel - DataSourceViewerModel 

* @param viewerFrame - DataSourceViewerFrame 

* @param dataSource - MDbNodeTreeData 
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piiblic void addUewViewerBasic (ViewerModel viewerModel, DataSourceViewerFrame 
viewerFrame, MDbNodeTreeData dataSource) 
throws DVException { 

if (viewerModel instanceof DataSourceViewerModel) 

addNewIntemalViewer ( (DataSourceViewerModel) viewerModel , viewerFrame, 

dataSource) ; 

else 

addNewExtemalViewer (viewerModel, viewerFrame, dataSource); 



* ®parain viewerModel - DataSourceViewerModel 

* ©param viewerFrame - DataSourceViewerFrame 

* oparam dataSource - MDbNodeTreeData 
*/ 

iwerModel, DataSourceViewerFrame 

String operationName = "Add New " + viewerModel .getModelTypeName ( ) + " Views 

setCursor(Cursor.getPredefinedCursor (Cursor. WAIT_CURSOR) > ; 
fireOperationBegun (operationName) ,- 

try { 

addNewViewerBasic (viewerModel, frame, dataSource); 
} catch (Exception exception) { 

if (exception instanceof NullPointerException) 

fireOperationFailed (operationName + " DUE TO Data source seti. 

improperly. ") ; 

else 

fireOperationFailed (operationName + " DUE TO " + 
exception.getMessage () ) ; 

) catch (Error error) { 

fireOperationFailed (operationName + " DUE TO " + error . getMessage () ) 

} 



= Add a sub frame for the specified 
<p> 

t @param viewerModel - ViewerModel 

>■ ®param frame - DataSourceViewerFrame - the frame to add 

iblic void addSubViewerFrame (ViewerModel viewerModel, DataSourceViewerFrame frame) { 



frame . addPropertyChangeListener (this) ; 
addPropertyChangeListener (frame) ; 

viewerModel .getPortal () . addPropertyChangeListener ( (Portal ViewerFrame) frame. getP 
ortalViewerFrame ( ) ) ; 

if (viewerModel instanceof DataSourceViewerModel) 



viewerModel. addPropertyChangeListener ( ( (DataSourceViewerFrame) frame) .getvie 

frame. setClosable (true) ; 
applyDeskTopContextTo (frame) ; 

' Apply the desktop context to the specified frame. 
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* ®param frame - DVGInternalFrarae 
*/ 

piiblic void applyDeskTopContextTo(DVGIntemalFrame frame) { 

( (DVGDesktop) getDesktopView ( ) ) . applyDeskTopContext To (frame) , 

} 



* Close the \ 
*/ 

public void close {) { 

SessionModel .getSession 0 .getDVGSharedlnstance {) . closeSessionWindow ( ) 



} 



* Copy the contents of a saved portal . 
*/ 

public void copyContentsAction () { 

notifyOperationBegunC'Copy contents of a saved portal"); 
try { 

PortalModel sourcePortalModel = loadPortalFile () ; 



if (sourcePortalModel != null) { 
Vector newViewers = 
getPortalModel () . copyContentsOf (sourcePortalModel) ; 

if (! newViewers . isEmpty () ) { 
// NOT YET IMPLEMENTED 
// Enumeration sourceViewersList = newViewers . elements ( ) 

// while (sourceViewersList .hasMoreElements 0 ) 

// 

viewViewer ( (MViewer) sourceViewersList .nextElement {) ) ; 
} 

notifyOperationFinishedC'Copy contents of a saved portal"); 

} 

} catch (Exception event) { 

notifyOperationFailedC'Copy contents of a saved portal"); 
System. err .println(" PortalModel Error in copying contents of Portal: 
System. err. println(" " + event .getClass () + ": " + 

event .getMessage ( ) ) ; 
/ / throw event ; 

} 



.t the portal - 

: void exitActionO { 

get Portal ViewerFrame {) .disposeO ; 



/** 

* Fetch the list of actions supported by this 

* editor. It is implemented to return the list 

* of actions supported by the embedded JTextComponent 

* augmented with the actions defined locally. 
*/ 

public Action [] getActionsO { 

Action [] defaultActions = { 

new CopyPortalContentsAction(this) , 
new SavePortalViewerAction(this) , 
new SaveAsPortalViewerAction(this) , 
new Ref reshPortalViewerAction(this) , 
new ExitPortalViewerAction{this) , 

new NewChartViewerAct ion (this) , 

new NewCrystalReportsViewerAction (this) , 

new NewHiGridViewerAction(this) , 



J NewMetaViewerAction (this) , 
i NewPlexusViewerAction(this) , 
i NewRecordViewerAction (this) , 
J NewSqlResultsViewerAction{this) , 
i ToggleShowSqlViewerAction{tliis) , 
J PortalViewerHelpAction(this) 



[] moreActions = TextAction. augmentList (super . getActions () , 
TextAction.a-ugraentList ( ( (DVGDesktop) getDesktopView () ) .getActic 



* Gets the controller for this resource- employing component. 

* <p> 

* ©return viewer - DVGDesktop Viewer 

public DVGDesktopViewer getCommandDesktop Viewer () { 
{ (PortalViewerFr; 



* @param dataSourceOirectory - DataSourceDirectory 
public DataSourceDirectory getDataSourceDirectory ( ) { 

return ( (DataSourceDirectoryControllerFrame) 

( (DVGDesktopViewer) getCommandDesktopViewer ( ) ) .getDataSourceDirectoryControllerF 
. getTypedViewer ( ) . getDataSourceDirectory ( ) ; 

} 

* Gets the desk top view. 

* <p> 

* ©return desktopView - JLayeredPane 
*/ 

public JLayeredPane getDesktopView ( ) { 
return desktopView; 

} 

* Gets the portal's model. 

* <p> 

* ©return portalModel - PortalModel 
*/ 

public PortalModel getPortalModel { ) { 
return portalModel; 

} 

* Gets the frame for this viewer. 

* <p> 

* ©return frame - PortalViewerFrame 

public PortalViewerFrame getPortalViewerFrame () { 

return ( (PortalViewerFrame) getViewerController ( ) ) ; 

} 

/** 

* Gets the selected Data Source from the Data Source Directory. 
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* ©parara selectedDataSource - MDbNodeTreeData 
*/ 

public MDbNodeTreeData getSelectedDataSourceO 
throws DVException { 

(MDbNodeTreeData) getOataSourceDirectoryO .getSelectedDataSource () ; 



* Gets the Transcript Controller frame. 

* <p> 

* ©return frame - TranscriptControllerFrame 

piiblic TranscriptControllerFrame getTranscriptControllerFrame () { 



( (DVGDesktopViewer)getCommandDesktopViewer() ) . getTranscriptControllerFrame ( ) ; 
} 

* Gets the controller for this viewer. 

* <p> 

* ®return frame - PortalViewerFrame 

public PortalViewerFrame getViewerController ( ) { 
return viewerController ; 

} 



* Initialized this viewer. 
*/ 

public boolean initialize {) { 

if (portalModel == null) 

portalModel = new PortalModel () ; 



alizing this class with the view 



initialize ( "Portal Viewer" , (DVGDesktop) desktopView) ; 
commandsSetEnabledCtrue) ; 



* Implements InternalFraraeListener . 

* <p> 

* Do nothing here . 

public void internalFraraeActivated (InternalFrameEvent e) { 
} 

/** 

* Implements InternalFrameListener . 

* Do nothing here. 

*l . r 

public void internalFrameClosed ( InternalFrameEvent event) { 

} 

/** 

* Implements InternalFrameListener. 

* <p> 

* Do nothing here . 

public void internalFrameClosing {InternalFrameEvent e) { 



} 



* Implements Internal FratneListener. 

* <p> 

* Do nothing here . 
*/ 

public void internalFrameDeactivated (InternalFrameEvent < 



* Implements InternalFrameListener . 

* <p> 

* Do nothing here . 

public void internalFrameDeiconified (InternalFrameEvent e) { 

} 

/** 

* Implements InternalFrameListener. 

* <p> 

* Do nothing here . 

public void internalFramelconif ied(InternalFrameEvent e) { 



* Implements InternalFrameListener. 

* <p> 

* Do nothing here . 

public void internalFraraeOpened (InternalFrameEvent e) { 
} 

/** 

* Load a portal (model) from a file. 

* <p> 

* ©return sourcePortal - PortalModel - the model of the loaded Portal 
*/ 

p\iblic PortalModel loadPortalFile () { 

PortalModel sourcePortal = null; 

File file = getFileToOpenO ; 
if (file != null) { 

if (file.existsO) { 
try { 

FilelnputStream fin = new FileInputStream(f ile) ; 
Object InputStream stream = new ObjectlnputStream (f in) ; 
sourcePortal = (PortalModel) stream. readobject () ; 
} catch (lOException io) { 

// should put in status panel 

System. err. printlnC'IOException: " + io .getMessage () ) ; 
} catch (ClassNotFoundException cnf) { 
// should put in status panel 
System. err.println( "Class not found: " + 

cnf .getMessage () ) ; 

} 

revalidate ( ) ; 

} else 

f ireExceptionRaised (new 
FileBeingOpenedDoeslIotExistException(f ile .getName 0 ) ) ; 
} 

return sourcePortal; 

} 

* Launch a new cha 
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void newChartViewer ( ) { 
newChartViewer (null) ; 



* Launch a new chart viewer frame . 



* @param dataSource - MDbModeTreeData - data source to apply to the viewer 

public void newChartViewer {MDbNodeTreeData dataSource) { 

addNewViewerOperation(new MViewerChart (getPortalModel { ) ) , new 
ChartResultsViewerFrame( (PortalViewerFrame)getViewerController 0 , getDesktopViewO ) 
dataSource) ; 
} 

* Launch a new plexus viewer frame . 
public void newCrystalReportsViewer ( ) { 

newCrystalReportsViewer (null) ; 

} 

/** 

* Launch a new Crystal Reports viewer frame. 

* ^aram dataSource - MDbNodeTreeData - data source to apply to the viewer 
*/ 

public void newCrystalReportsViewer (MDbNodeTreeData dataSource) { 

addlJewViewerOperation(new MViewerCrystalReports (getPortalModel () ) , new 
CrystalReportsViewerFrame ( ( Portal ViewerFrame) getViewerController ( ) , getDesktopView ( 
dataSource) , 

/** 

* Launch a new meta viewer frame . 
public void newMetaViewer ( ) { 

newMetaViewer (null) ; 

} 

/** 

* Launch a new meta viewer frame . 

* ©param dataSource - MDbNodeTreeData - data source to apply to the 

public void newMetaViewer (MDbNodeTreeData dataSource) { 

addNewViewerOperation(new MViewerMeta{getPortalModel 0 ) , new 
MetaViewerFrame ( (PortalViewerFrame) getViewerController { ) , getDesktopVie 
dataSource) ; 



* Launch a new plexus viewer frame. 
*/ 

pt±ilic void newPlexusViewer 0 { 
newPlexusViewer (null) ; 

} 

/** 

* Launch a new plexus viewer frame . 

* ©param dataSource - MDbNodeTreeData - data source to apply to the vis 

*/ . r 

public void newPlexusViewer (MDbNodeTreeData dataSource) { 
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addNewViewerOperation(new MViewerPlexus (getPortalModel {) ) , new 
PlexusResultsViewerFrame ( (PortalViewerFrame) getViewerController ( ) , getDesktopView ( ) ) , 
dataSource) ; 
} 



* Launch a new chart viewer frame, 
public void newRecordViewer () { 

newRecordViewer (null) ; 

} 

* Launch a new chart viewer frame. 

* @param dataSource - MDbNodeTreeData - data source to apply to the viewer 

public void newRecordViewer (MDbNodeTreeData dataSource) { 

addNewViewerOperation(new MViewerRecord(getPortalModel () ) , new 
RecordResultsViewerFrame ( (PortalViewerFrame) getViewerController ( ) , getDesktopView ( ) ) , 
dataSource) ; 
} 



* Launch a new SQL viewer frame, 
public void newSqlViewer ( ) { 

newSqlViewer (null) ; 

} 

/** 

* Launch a new SQL viewer frame. 

* ®param dataSource - MDbNodeTreeData - data source to apply to the viewer 

public void newSqlViewer (MDbNodeTreeData dataSource) { 

addNewViewerOperation (new MViewerSql (getPortalModel ( ) ) , new 
SqlResultsViewerFrameC (PortalViewerFrame) getViewerController 0 , getDesktopView ( ) ) , 
dataSource) ; 
} 



* Launch a new grid viewer frame , 
*/ 

public void newTableViewer ( ) { 
newTableViewer (null) ; 

} 



* Launch a new grid viewer frame. 

* ®param dataSource - MDbNodeTreeData - data source to apply to the viewer 

public void newTableViewer (MDbNodeTreeData dataSource) { 

addNewViewerOperation (new MViewerHiGrid (getPortalModel ()) , new 
VPHDesktopHiGridViewerFrame ( { PortalViewerFrame ) getViewerCont rol ler () , 
getDesktopView { ) ) , dataSource) ; 
} 

/** 

* Notify that an operation has begun. 

* ©parara operationName - String - name of the operation that is beginning 
public void not if yOperationBegun (String operationName) { 

getTranscriptControllerFrame 0 . fireOperationBegun (operationName) ; 

} 
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* Notify that an operation has canceled. 



* oparam operationName - String - name of the operation that is canceled 
public -void notifyOperationCanceled (String operationNarae) { 

getTranscriptControllerFrame 0 . f ireOperationCanceled (operationName) ; 

] 



* Notify that an operation has failed. 

* @^aram operationName - String - name of the operation that has failed 
public void notifyOperationFailed (String operationName) { 

getTranscriptControllerFrame ( ) . fireOperationFailed (operationName) ; 

} 

/** 

* Notify that an operation has finished. 

* ®param operationName - String - name of the operation that has finished 
public void notifyOperationFinished(String operationName) { 

getTranscriptControllerFrame () . fireOperationFinished (operationNarae) ; 

} 

* Called when a bound property is changed, 

* <p> 

* Sparam evt PropertyChangeEvent 

public void propertyChange ( PropertyChangeEvent event) { 
tracePropertyChange (event) ; 

if (event. getPropertyName {) .equals ("Connection Available") ) { // e.g., SQL 
command executed 

Object value = event . getNewValue 0 ; 
if (value instanceof MDbNodeTreeData) 

viewDataBaseConnection{ (MDbNodeTreeData) value) ; 
else if (value instanceof MDbTreeProperties) 

viewDataBaseConnection ( (MDbTreeProperties) value) ; 
) else if (event.getPropertyNameO -equals ("DB Results Viewer Frame Exceptioi 

f ireDbResultsViewerException( (DVException) event .getNewValue () ) ; 
else if (event.getPropertyNameO .equals ("DB Results Viewer Frame Error")) 

f ireDbResultsViewerError ( (DVError) event . getNewValue () ) ; 
else if (event.getPropertyNameO .equals("isClosed") ) 
finalizeListenerIsClosed(event.getSource{) ) ; 
else if (event.getPropertyNameO . equals (PortalModel . VIEWER_MODEL_ADDED) ) 

//viewDataBaseConnection ( ( (MViewer) event . getNewValue ( ) ) . getDataModel ( ) ) ; 



* Refresh the portal . 
public void ref reshPortal ( ) { 
try { 

getPortalModel ( ) . ref reshPortal ( ) ; 

Vector sourceViewers = getPortalModel 0 .getviewers O ; 
if ( sourceViewers . isEmpty ( ) ) 
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Enumeration sourceViewersList = sourceViewers . elements () ; 
while (sourceViewersList .hasMoreElements 0 ) { 
DataSourceViewerModel viewerModel = 
(DataSourceViewerModel) sourceViewersList . nextElement () ; 

//viewerModel . getTreeProperties ( ) .notifyObservers {) ; 

MDbTreeProperties dataModel = 
viewerModel .getDataModelComponent ( ) ; 

dataModel . f ireJCDataEvent (new 
MDbJCDataEvent ( (Object) dataModel) ) ; 
} 

} catch (Exception event) { 

System. err .println(getClass() + "Error in refreshing the portal:' 
System. err. print In { " " + event .getClass ( ) + ": " + 

event .getMessage () ) ; 



/** 

* Saves the portal . 
*/ 

public void saveActionO { 
try { 

get Port alModel ( ) . savePortal { ) ; 
} catch (Exception event) { 

System.err .print In ("PortalModel Error in saving Portal:"); 

System. err .printlnC " + event .getClass ( ) + ": " + 

event . getMessage ( ) ) ; 
} 

} 



/** 

* Save As the portal . 
*/ 

public void saveAsAct ion ( ) { 

File file = getFileToSave () ; 

if (file != null) 
try { 

get PortalModel ( ) . saveAsPortal (getFileToSave ( ) ) ; 
} catch (Exception event) { 

System. err. printlnC" PortalModel Error in saving Portal:"); 
System, err. printlnC " + event . getClass ( ) + ": " + 

event . getMes sage ( ) ) ; 

} 

} 

/** 

* Sets the portal's model. 
*/ 

public void setPortalModel (PortalModel portalModel) { 
this .portalModel = portalModel; 

} 



/** 

* Show a new db viewer . 

* <p> 

* Sparam viewerModel - DataSourceViewerModel 

* ©pararn frame - DataSourceViewerFrame 

* ®param treeDataSource - MDbNodeTreeData 
*/ 

public void showDbViewer (DataSourceViewerModel viewerModel, DataSourceViewerFrame 
frame, MDbNodeTreeData treeDataSource) { 

addSubViewerFrame (viewerModel, frame) ; 

frame . addlnternalFraraeListener (get PortalModel ( ) ) ; 

IntemalResultsViewer viewer = ( (InternalResultsViewer) frame . getviewer ()) ; 
viewer. setDataSourceCustomizer ( ) ; 



if (treeDataSource 1= null) { 

viewer. setDataSource (treeDataSource) ; 

viewer . setViewControllerTitle (treeDataSource . getModelName () ) ; 
} else { 

f ireDbResultsViewerException { (DVException) new 
DataSourceCouldHotBeOpenedExceptionO ) ; 

viewer . setViewControllerTitle ( 

MessageKit . getMessageText ( "DBResultsViewer " , 
"DataSourceCouldKotBeOpened" ) 

} 

// check to see if data source was NOT set 
if ( viewer. getTreeDataSourceDataO == null) 

f ireDbResultsViewerException { (DVException) new 
DataSourceCouldNotBeOpenedExceptionO ) ; 

frame . setvisible (true) ; 

frame . f ireNewDbResultsViewerFrame ( ) ; 

} 

* Show a new external viewer. 

* <p> 

* ©param viewerModel - DataSourceViewerModel 

* ®param frame - DataSourceViewerFrame 

* ©param treeDataSource - MDbNodeTreeData 
*/ 

public void showExternalViewer (ViewerModel viewerModel, DataSourceViewerFrame frame, 
MDbNodeTreeData dataSource) { 

addSubViewerFrame (viewerModel, frame) ; 

frame . addlntemalFrameListener (getPortalModel { ) ) ; 

frame . setvisible (true) ; 

frame . f ireNewDbResultsViewerFrame () ; 

} 

* Notifies that a new data base connection was established. 
*/ 

public void viewDataBaseConnectionO { 

traceMessage (getclass ( ) + " : : viewDataBaseConnection" ) ; 

firePropertyChange ("SOL. Query Available" , null, VCPlexus . getTestEdges ( ) ) ; 
refresh () ,- 

} 



* View the data source using a table, that is grid, view. 

* <p> 

* ®param dataSource - MDbNodeTreeData 
*/ 

public void viewDataBaseConnection(MDbNodeTreeData dataSource) { 

traceMessage (getclass 0 + " >> viewDataBaseConnection for " + dataSource) ,- 

addNewViewerOperation(new MViewerHiGrid (getPortalModel {) , dataSource), new 
VPHDesktopHiGridViewerFrame ( (PortalViewerFrame) getViewerController ( ) , 
getDesktopView ( ) ) , null ) ; 



* Update the plexus view. 

* <p> 

* ©param treeProperties - MDbTreeProperties 
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public void viewDataBaseConnection (MDbTreeProperties treeProperties) { 
traceMessage (getClass 0 + " >> viewDataBaseConnection" ) ; 
f irePropertyChange ("SQL Query Available", null, (Object) treeProperties) ; 
( (DVGDesktop)getDesktopView{) ) . cascadeFrames ( ) ; 
refresh () ; 

} 

/** 

* <p> 

* @param viewerModel - ViewerModel - model of tlie viewer 
*/ 

public void viewViewer (ViewerModel viewerModel) { 



if (viewerModel instanceof MViewerHiGrid) 

frame = new VPHDesktopHiGridViewerFrame (hostFrame, getDesktopView () ) ; 
else if (viewerModel instanceof MViewerChart ) 

frame = new ChartResultsViewerFrame (hostFrame, getDesktopView ()) ; 
else if (viewerModel instanceof MViewerPlexus) 

frame = new PlexusResultsViewerFrame (hostFrame, getDesktopViewO ) ; 
else if (viewerModel instanceof MViewerRecord) 

frame = new RecordResultsViewerFrame (hostFrame, getDesktopViewO); 
else if (viewerModel instanceof MViewerCrystalReports) 

frame = new CrystalReportsViewerFrame (hostFrame , getDesktopViewO ) ; 
else if (viewerModel instanceof MViewerSql) 

frame = new SqlResultsViewerFrarae (hostFrame, getDesktopViewO); 
else if (viewerModel instanceof MViewerMeta) 

frame = new MetaViewerFrarae (hostFrame, getDesktopViewO); 

if (viewerModel instanceof DataSourceViewerModel) 

showDbViewer ( (DataSourceViewerModel ) viewerModel , frame , 
{ (DataSourceViewerModel) viewerModel) . getDataModel O ) ; 
else 

showExternalViewer (viewerModel, frame, null); 

} 
} 

package com . dor . dvg . view . portal ; 
/** 

* @ {#) PortalViewerFrame. java 



* The <code>PortalViewerFrame</code> is the frame for a <code>PortalViewer</code> , 

* <p> 

* ©author Edward L. Stull 

* ©vers ion 1 . 13 

* ©since JDK 2 
*/ 

//34 5 678901234 567 890 123456 789 0123456789012345578 9*1234557 8 901234 5678 90123456 789 0 

import j ava . awt . Dimension ; 

import j ava . beans . Property ChangeEvent ; 

import j ava . beans . PropertyVetoException; 

import j ava. util. Enumeration; 

import j ava . util . Vector ; 



import com . dcr . dve . model . mdb . MDbNodePropert ies ; 
import com . dcr . dve . model . mdb . MDbNodeTreeData ; 

import com . dcr . dve .model .racommand .mccompiler .mccparser. Parse ; 

import com. dcr .dve .view. vprocess . vphigrid . VPHDesktopHiGridViewerPrame ; 



:i . dcr . dvg .model .portal . directory . PortalModel ; 
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import c 
import c 
import ( 

import c 
import c 

import ( 

import ( 
import < 

import < 
import < 
import < 
import ( 
import ( 
import < 



dcr . dvg . model . 
dcr.dvg. model . 
dcr .dvg. model . 
dcr .dvg. model . 
dcr .dvg. model . 
dcr . dvg . model . 
dvg . model . 



ViewerModel ; 
DataSourceViewerModel ,- 
MViewerChart ; 
MViewerCrystalReports ; 
MViewerHiGrid ; 
MViewerRecord ; 
MViewerPlexus ; 



dc r . dvg . ut i 1 . throwabl e . DVErr or ; 
dcr . dvg .util . tlirowable . DVException; 
dcr . dvg . ut il . throwable . KoDataSourceSele 



;tedForQueryExecutionExcepti( 



dcr .dvg. - 
dcr.dvg.' 
dcr.dvg.- 
dcr.dvg.- 
dcr.dvg . ■ 
dcr.dvg.- 
dcr.dvg . - 
dcr.dvg.- 
dcr.dvg.- 
dcr . dvg . ■ 
dcr . dvg . ■ 



w . component . desktop . DVGDesktop ; 

w. component .desktop . DVGInternal Frame; 

M . control ler . datasource . Dat aSourceDirectory ; 

M. controller . datasource -DataSourceDirectoryControllerFrame; 

w . controller . portal . Port alDi rectoryCont rol ler ; 

H. controller . portal . PortalDirectoryControllerFrame ; 

w. desktop . DVGDesktopViewer ; 

w . dspro j ect ion . DataSource-Viewer Frame ; 

w.dsprojection . chart . ChartResultsViewerFrarae; 

w . dspro j ection . crystalreport s . CrystalReportsViewerFrame ; 

w.dsprojection. plexus . PlexusResults-ViewerFrame ; 

H . dspro j ect ion . record . RecordResult s-ViewerFrame ; 



public class Portal ViewerFrarae extends D-VGInternalFrame { 

protected boolean hasExceptionOrErrorOc cured = false 
protected MDbNodeTreeData dbConnection = null; 

/** 



* Oparam desktopView - JLayeredPane - the parent ( 

* Sparara f rameDimension - Dimension - the dimension of the fr; 



: PortalViewerFrame ( JLayeredPai 
super (desktopView, frameDime 



\ desktopView, Dimension f rameDimension) 



* Find the frame with the specified i 



*/ 



leNameObject) { 



J Error ("INTERNAL ERROR: f indFrameWithUame could not find i 



public DataSourceViewerFrame f indFrameWithName (Obje( 
JInternalPrame [] frames = getAllFrames ( ) ; 
for (i] 

if (frai 



-* Fire "DB Results Error" property change for an error. 

* <p> 

* ©param error - DVError 
*/ 

public void fireDbResultsError (DVError error) { 

traceMessage (getClass 0 + " >>f ireDbResultsError = 
setExceptionOrErrorOccured ( ) ; 

f irePropertyChange ( "DB Results Error", null, errc 

} 



* Fire "DB Results Exception" property change for an exception. 

* <p> 

* Oparam exception - DVException 
*/ 

public void fireDbResultsException (DVException exception) { 
if (TRACE) 

traceMessage (getClass ( ) + " >> fireDbResultsException =" + 
setExceptionOrErrorOccuredO ; 

f irePropertyChange ( "DB Results Exception", null, exception); 

} 



/** 

* Fire that SQL query (frame) are available. 

* <p> 

* Oparam dataSource - MDbNodeProperties 
*/ 

pijblic void fireDBSqlQueryAvailable (MDbNodeProperties dataSource) { 

f irePropertyChange ( "SQL Query Available", null, (Object) dataSource) ; 

} 



* Fire that SQL query results (frame) are available. 

* <p> 

* ©parara dataSource - MDbNodeProperties 
*/ 

public void f ireSglQueryResultsAvailable ( ) { 

f irePropertyChange (" SQL Query Results Available", null, new Boolean(true 

} 



/** 

* Gets all JInternalFrames currently displayed in the 

* desktop. Returns iconified frames as well as expanded frames. 

* <p> 

* ©return fraraesArray - an array of JInternalFrarae objects 
*/ 

public JInternalFrame [] getAllFraraes ( ) { 

JInternalFrame [] results; 

Vector vResults = new Vector (10) ; 

Object next, tmp; 

count = getComponentCount ( ) ; 
for (i = 0; i < count; i++) { 

next = getComponent (i) ; 

if (next instanceof JInternalFrame) 
vResults . addElement (next) ; 

else 

if (next instanceof JInternalFrame .JDesktopIcon) { 

tmp = ( (JInternalFrame .JDesktopIcon) next) .getlnternalFrame () ; 
if (tmp •= null) 

vResults . addElement (tmp) ; 

} 

} 

results = new JInternalFrame [vResults . size ()] ; 
vResults . copylnto (results) ; 

return results; 

} 



/** 

* Gets all frames on selected layers. 

* <p> 

* ©return framesArray - an array of JInternalFrame objects 



pijblic JlnternalFrame [] getAllFramesOnMarkedLayers ( ) 
vector frames = new Vector(lO); 



* Gets the controller for this resource-employing component. 

* ©return viewer - DVGDesktopViewer 
*/ 

public DVGDesktopViewer getCommandOesktopViewer ( ) { 



/** 

* Gets the Data Source Directory (view) . 



1 dataSourceDirectory DataSourceDirectory 
*' . 

public DataSourceDirectory getDataSourceDirectory ( ) { 



(DataSourceDirectory) ( (DataSourceDirectoryControllerFrarae) getDesktopViewer () .getOataSo 
urceDirectoryControllerFrame { ) ) . getTypedViewer ( ) .getDataSourceDirectory () ; 
} 

/** 

* Gets the desktop viewer. 

* <p> 

* ©return desktopViewer - DVGDesktopViewer 
*/ 

public DVGDesktopViewer getDesktopViewer ( ) { 

return (DVGDesktopViewer) ( (DVGDesktop) getDesktopView { ) ) . getCont roller (} ; 

} 

/** 

* Gets the Portal Directory Controller. 

* <p> 

* @param portalDirectoryController - PortalDirectoryController 
*/ 

public PortalDirectoryController getPortalDirectoryController ( ) { 



(PortalDirectoryController) ( ( PortalDirectoryControllerFrame) getDesktopViewer ( ) .getPort 
alDirectoryControllerFrame ( ) ) .getViewerO ; 
} 

* Gets the viewer. 

* <p> 

* ©parara portalviewer PortalViewer 
*/ 

public PortalViewer getPortal Viewer { ) { 
return (PortalViewer) getviewer ( ) ; 

} 

* Gets the portal viewer. 

* <p> 

* ©return portalviewer PortalViewer 
*/ 

public PortalViewer getResultsViewer ( ) { 
return (PortalViewer) getViewer () ; 

} 
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/** 

* Gets the selected portal from the portal directory viewer. 

* <p> 

* ©return selectedPortal - PortalModel 
*/ 

public PortalModel getSelectedPortal { ) { 

return (PortalModel) getPortalDirectoryController {) . getSelectedPortal { ) ; 

} 



/** 

* Answer if an exception or error has occured during results genteration. 

* <p> 

* ©return hasExceptionOrErrorOccured - boolean 
*/ 

piiblic boolean hasExceptionOrErrorOccured () { 
return hasExceptionOrErrorOccured; 

} 



* Called when a bound property is changed, 

* <p> 

* ©param evt - PropertyChangeEvent 
*/ 

piiblic void propertyChange (PropertyChangeEvent event) { 
tracePropertyChange (event) ; 

if (event .get PropertyName 0 .equals { "Sql Query Pending")) 
viewPortal ( ) ; 

else if (event -getPropertyName 0 . equals ( "DB Results Viewer Exception")) 
f ireDbResultsException ( (DVException) event . getNewValue ( ) ) ; 

else if ( event. get PropertyName 0 .equal s("DB Results Viewer Error")) 
f ireDbResultsError { (DVError) event .getNewValue ( ) ) ; 

else if (event .getPropertyName ( ) . equals (PortalModel .VIEWER_MODEL_ADDED) ) 
getViewerO . propertyChange ( event ) ; 

super .propertyChange (event) ; 

} 



/** 

* Sets an exception or error has occured during results genteration. 
*/ 

public void setExceptionOrErrorOccuredO { 
hasExceptionOrErrorOccured = true; 

} 

/** 

* This is the dynamic creation of a viewer in that it is created based on the 

* semantics of a portal which are not known a priori. 
*/ 

public void viewPortal () { 

viewPortal (new PortalModel () ) ; 

} 



/** 

* This is the dynamic creation of a viewer in that it is created based on the 

* semantics of a portal which are not known a priori. 
*/ 

piiblic void viewPortal (PortalModel portalModel) { 

setTitle (getSelectedPortal 0 .getNameO + " #" + getDbResultsFrameldO ) ; 
setviewer (new Portal Viewer (this) ) ; 

getPortalViewer 0 . addPropertyChangeListener (this) ; 
getPortalViewer 0 . setPortalModel (portalModel) ; 
getPortalViewer () . initialize ( ) ; 
getPortalViewer 0 . viewDataBaseConnection ( ) ; 



53 



setContentPane (getPortalViewer { ) ) ; 



int layer = DVGDesktop . OUTPUT_IIAYER; 
setNewFrameBouncis (layer) ; 

getDesktopViewO -add (this, new Integer (layer) ) ; 

if (! hasExceptionOrErrorOccured 0 ) { 

// next line to clean problem with apparently JCTable ghost on desktop 
// hopefully will be fixed by vendors later 
getDesktopViewO .repaint () ; 

viewViewers (portalModel .getViewers 0 ) ; 

getResTiltsViewer () . refresh {) ; 
refresh () ; 

f ireSqlQueryResultsAvailable () ; 

} else 

dispose () ; 

} 



/** 

* <p> 

* ®param viewerModel - ViewerModel 
*/ 

public void viewViewer (ViewerModel viewerModel) { 

MDbNodeTreeData treeDataSource = 
( (DataSourceViewerModel) viewerModel) .getDataModel { ) ; 

if (viewerModel instanceof MViewerHiGrid) 

getPortalViewer 0 . showDbViewer ( (DataSourceViewerModel) viewerModel, new 
VPHDesktopHiGridViewerFrame (this, getDesktopViewO), treeDataSource) ; 
else if (viewerModel instanceof MViewerChart ) 

getPortalViewer ( ) . showDbViewer ( (DataSourceViewerModel) viewerModel , new 
ChartResultsViewerFrame (this, getDesktopViewO), treeDataSource) ; 
else if (viewerModel instanceof MViewerRecord) 

getPortalViewer ( ) . showDbViewer ( (DataSourceViewerModel ) viewerModel , new 
RecordResultsViewerFrame (this, getDesktopViewO ) , treeDataSource) ; 
else if (viewerModel instanceof MViewerPlexus) 

getPortalViewer { ) . showDbViewer ( (DataSourceViewerModel ) viewerModel , new 
PlexusResultsViewerFrame (this, getDesktopViewO ) , treeDataSource) ; 
else if (viewerModel instanceof MViewerCrystalReports) 

getPortalViewer O . showExternalVi ewer (viewerModel, new 
CrystalReportsViewerFrame (this, getDesktopViewO), null); 
} 

/** 

* View the portal ' s viewers . 

* <p> 

* @param viewers - Vector 
*/ 

public void viewViewers (Vector viewers) { 
if (viewers == null) 



Enumeration viewersList = viewers . elements () ; 
while (viewersList .hasMoreElements ( ) ) 

viewViewer ( (DataSourceViewerModel) viewersList . nextElement O ) ; 
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workflow 



package com.dcr . dvg . view . controller . datasource ; 

* @ C#) DataSourceDirectoryController . j ava 

* <p> 

* <p> 

* The <code>DataSourceDirectoryController</code> class is a view of the 

* of a Data Source Directory with features for management . 

* <p> 

Edward L. Stull 
JDK 2 



import ; 

import ; 
import : 
import ; 
import ; 
import ; 
import ; 
import ; 
import ; 

import : 
import : 
import ; 
import : 



awt .Dimension; 
awt . FileDialog; 

awt . Image ; 

I. beans. Beans; 

I . beans . PropertyChangeEvent ; 
io.File; 
io. lOException; 
util .Hashtable; 

: . swing . Act ion ; 
: . swing . JLayeredPane ; 
: . swing . SwingConstant s ; 
: . swing . text . TextAction; 



import com. dcr .dve .-s 
import com. dcr .dve .1 
import com.dcr .dve .-s 



import < 
import ( 
import < 
import ( 
import < 
import < 

import < 
import < 
import ( 
import ( 
import < 
import < 
import ( 
import < 
import < 
import ( 
import ( 
import < 
import t 
import < 
import ( 
import c 



1. dor. dve. view 

i.dcr .dve 
i.dcr.dve 



vcomponent -VCBorderLayout; 
vcomponent .vccontrol . VCControlBar; 
vcomponent . VCSplitViewer ; 
vcomponent . vcdialog.VCOptionDialog; 
vcomponent .vcpanel . VCScrollViewer ; 
vprocess . IVPDataSourceCustomizerControlle: 
vprocess . IVPView; 

VPDataSourceCustoraizer; 
Viewer; 



n. dcr. dvg .model -datasource . directory .DataSourceDirectoryDataSourceNodeModel ; 

n. dcr. dvg .model .datasource . directory .DataSourceFolderModel; 

ci . dcr . dvg .model . datasource . directory . DataSourceDirectoryFolderNodeModel ; 

n.dcr .dvg .model .datasource . directory .DataSourceDirectoryNodeModel; 

a . dcr . dvg .model . datasource . directory . DataSourceDirectoryModel ; 

[I. dcr . dvg .model . tree . ITreeFolderWodeModel ; 

ti . dcr . dvg .model . tree . explorer . lExplorerFolderModel ; 

a.dcr .dvg .model -tree . explorer . TreeDirectoryModel ; 

a. dcr . dvg .util . throwable . DVException; 

ti.dcr .dvg .util . throwable -NoDataSourceSelectedExcept ion; 

a. dcr. dvg. util . throwable -NoDataSourceFolderSelectedException; 

fi . dcr . dvg .util . throwable . DVShouldNotBeReachablelnternalError ; 

n. dcr .dvg .util . throwable . UnableToNewDataSourceDirectoryError ; 

[1. dcr. dvg. util . throwable. UnableToOpenDataSourceDirectoryFileExcept ion; 

n. dcr . dvg .util . throwable . UnableToSaveDataSourceDirectoryError ; 

a. dor . dvg .util . throwable .UnableToSaveDataSourceDirectoryFileExcept ion; 



import com. dcr. dvg. view. cont 
import com. dcr . dvg .view. controller . datasource . i 
import 

com . dcr . dvg . view . controller . 



i.DataSourceDirectoryCont roller InPlaceActi 



r. controller -datasource . 



import com. dcr- dvg. -s 
import com.dcr .dvg. 
import com. dcr. dvg. -s 
import com. dcr. dvg. 1 
import com . dcr . dvg . ^ 
import com. dcr. dvg. A 



:. datasource 



1 . controlli 
7. controlli 
f.controll: 
7. controll: 
7. controller . datasource 
f.controll- 



DataSourceDirectoryControllerFolderActio 

i.EditDataSourceFolderAction; 
i-EditDataSourceAction; 
1 . NewDat aSourceDir ect oryAct ion ; 
i-OpenDataSourceDirectoryAction; 
1 - SaveDat aSour c eD i rec t oryAct ion ; 
1 - SaveAsDataSourceDirect oryAct ion ; 
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import 

com.dcr .dvg.- 
import 

import 

com. dcr -dvg .■ 
import 

com. dcr .dvg. ■ 



controller .datasource 
f . controller . datasource 
7 . controller . datasource 
f . controller .datasource 

i. controller -dati 



import com . dcr . dvg 
import com. dcr. dvg 
import 
com. dcr. dvg 
import 
com. dcr. dvg 
import 
com. dcr. dvg 
tException; 
import 
com. dcr. dvg 

import 

com. dcr. dvg.- 
entException 
import 

com. dcr. dvg.- 
import 

com. dcr. dvg. - 
ntException; 
import 

com.dcr .dvg .- 



controller .dati 
controller . dat; 
controller . dati 

view . controller . dat 



f. controller . dati 



J . controller . dataso-urce . except i< 



action. CopyDataSourceDirectorYElementAct ion, 
1 - CutDataSourceDirectoryElement Act ion ; 
i.DeleteDataSourceDirectoryElementActic 
1. PasteDataSourceDirectoryElementActioi 

1 . ToggleShowAsDataSourceDbResultsActioi 



1 . UnableToAddDataSourceExcept ion ; 

1 . UnableToAddDataSourceFolderExcept ion; 

I . UnableToCopyDataSourceDirectoryElemen 

i.UnableToCutDataSourceDirectoryElement 

i.UnableToDeleteDataSourceDirectoryElem 

1 . UnableToNewDataSourceDirectoryExcept i 

i.UnableToPasteDataSourceDirectoryElerae 

1 . UnableToSaveDataSourceDirectoryExcept 

i.UnableToSaveAsDataSourceDirectoryExce 



. except ii 



import ( 
import < 



1 . dcr . dvg . -\ 



il .throwable .NoDataSourceFolderSelectedException; 
ew . controller . iteration . Iterat ionControllerFrame ; 
ew.dsproj action . DataSo-arceViewerFrame ; 



public class 
extends Dii 
implements 



DataSourceDirectoryController 
ectoryController 

.rceCustomizerController { 



protected DataSourceViewerFrame previewDataSourceFrame = null; 



protected Exist ingDataSourceFolderWizard existingDataSourceFolderPanel; 
protected NewDataSourceFolderWizard newDataSourceFolderPanel; 
//protected VPCommandConnectionExistingConnectionWizard 
ixistingConnectionPanel; 

//protected -VPCommandConnectionNewComiectionWizard newConnectionPanel ; 



static String [] DataSourceOptionNames = 
protected boolean dialogActive; 



{ "Set", 



' Constructor. 
*/ 

public DataSourceDirectoryContr< 
super { ) ; 

} 
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* Constructor based on the desktop. 

* <p> 

* ©paratn desktopView - JLayeredPane 
*/ 

public DataSourceDirectoryController (JLayeredPane desktopView) { 
super ( ) ; 

setDesktopView (desktopView) ; 
initialize 0 ; 

} 



* Add a Data Source . 

public void actionAddDataSource (DataSourceDirectoryControllerFolderAction action) { 
applyOperation (action) ; 

) 



* Add a new folder. 
*/ 

public void actionAddDataSourceFolder (DataSourceDirectoryControllerFolderAction 
action) { 

applyOperation (action) ; 

} 



* Copy a directory element . 
*/ 

public void 

actionCopyDataSourceDirectoryNode (DataSourceDirectoryControllerFolderAction action) { 
applyOperation (action) ; 

} 

/** 

* Copy a new directory element . 
*/ 

public void actionCutDataSourceDirectoryNode (DataSourceDirectoryControllerFolderAction 
action) { 

applyOperation (action) ; 

} 

/** 

* Delete the selected Data Source Directory element Action. 
*/^ -d 

actionDeleteDataSourceDirectoryNode (DataSourceDirectoryControllerFolderAction action) 
{ 

applyOperation (action) ; 

} 

* Edit a Data Source. 

public void actionEditDataSource (DataSourceDirectoryControllerlnPlaceAction action) { 
applyOperation (action) ; 

} 

* Edit a Data Source Folder . 
*/ 

public void actionEditDataSourceFolder (DataSourceDirectoryControllerlnPlaceAction 
action) { 

applyOperation (action) ; 
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} 

/** 

* Get new Data Source Directory. 
*/ 

public void actionNewDataSourceDirectory (DataSourceDirectoryControllerlnPlaceAction 
action) { 

applyOperation (action) ; 

} 

/** 

* Open a "saved" data source directory. 
*/ 

public void actionOpenDataSourceDirectory (DataSourceDirectoryControllerlnPlaceAction 
applyOperation (action) ; 

} 

* Paste an element to a folder. 
*/ 

public void 

actionPasteDataSourceDirectoryNode (DataSourceDirectoryControllerFolderAction action) { 
applyOperation (action) ; 

} 

/** 

* Save the data source directory. 
*/ 

piiblic void actionSaveAsDataSourceDirectory (DataSourceDirectoryControllerlnPlaceAction 
applyOperation (action) ; 

} 

/** 

* Save the data source directory. 
*/ 

public void actionSaveDataSourceDirectory (DataSourceDirectoryControllerlnPlaceAction 
action) { 

applyOperation (action) ; 

} 

public void actionToggleShowAsDbResults ( ) { 

if (! getShowAsDbResultsO ) 

setShowAsDbResults (true) ; 

setShowAsDbResults (false) ; 

} 



* Add a new portal folder. 

* <p> 

* @parara folderNode - ITreeFolderNodeModel - folder to add 
piiblic boolean addFolder (ITreeFolderNodeModel folderNode) { 

boolean completed = true; 

int selection = VCOptionDialog. showOptiohDialog ( 
this, 

/ /parent Component 

newDataSourceFolderPanel .update 0 , //message - object to display 
"New Data Source Folder Information" , //title - title string for the 

dialog 

VCOptionDialog. DEFAULT_OPTION, //optionType - 

YES_NO_OPTION or YES_NO_CANCEL_OPTION 



4. 



VCOptionDialog-QUESTION_MESSAGE, //inessageType - ERROR_MESSAGE , 

ION_MESSAGE, etc 

null, //icon - 

icon to display in the dialog 

AddElementOptionNames, //options - array of 

possible choices 

AddElementOptionNames [1] ) ; //initial Value - object 

that is the default selection 

if (selection == VCOptiohDialog.OK_OPTION) { 
setvisible (true) ; 

newDataSourcePolderPanel -getEditor {) .setFolderO ; 
newDataSourceFolderPanel . getEditor ( ) . getFolder ( ) . setOwner (MUserContext . getUserl 

dO) ; 

getDataSourceDirectoryModel (> . insertNode ( 

DataSourceDirectoryFolderNodeModel (newDataSourceFolderPanel .getEditor 0 . getFolder () ) , 
getFolderNodeOf Select edDataSource ( ) 

) ; 

getDataSourceDirectory ( ) . invalidate ( ) ; 
updateView ( ) ; 

} else 

completed = false; 
return completed; 

} 

/** 

* Add a new data source, that is, terminal to the tree. 

* <p> 

* @param folderNode - ITreeFolderNodeModel - folder to add to 
public boolean addTerminaK ITreeFolderNodeModel folderNode) { 

boolean completed = true; 

String title = getMessageUsingResource ( "DataSourceWizardDialogTitle" ) ; 
VPDataSourceCustomizer customizer = showDataSourceWizardDialog (true, title); 

if (customizer != null) { 

getDataSourceDirectoryModel ( ) 
. insertNode ( 



) ; 

refresh () ; 

updateView () ; 

completed = fa 

completed; 
} 

* Clear that a dialog is act 
*/ 

public void clearDialogActive 
dialogActive = false; 

} 

/** 

* Clear the results viewer. 

* <p> 

* DO NOTHING HERE 
*/ 

public void clearViewO ( 
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} 



/** 

* Copy a directory node. 

* <p> 

* eparam folderNode - ITreeFolderNodeModel - folder to add to 
public boolean copyNode (ITreeFolderNodeModel folderNode) { 

boolean completed = true,- 
try { 

getDataSourceDirectoryModel { ) . copyToClipBoardNodeOf ( (DataSourceDirectoryNodeMod 
el)getDataSourceDirectory{) .getSelectedNode ( ) ) ; 

getDataSourceDirectory ( ) . invalidate ( ) ; 
} catch (Exception exception) { 

f ireDbResultsException (new 
UnableToCopyDataSourceDirectoryEleraentException (exception) ) ; 
completed = false; 



* Cut a directory element. 

* @param folderNode - ITreeFolderNodeModel - folder to cut from 
*/ 

public boolean cutNode ( ITreeFolderNodeModel folderNode) { 
boolean completed = true; 
try { 

getDataSourceDirectoryModel {) . cutToClipBoardNodeOf { (DataSonrceDirectoryNodeMode 
1) getDataSourceDirectory 0 . getSelectedNode { ) ) ; 

getDataSourceDirectory 0 . invalidate () ; 

//will reset clipboard ==> updateViewO ; 
} catch (Exception exception) { 

f ireDbResultsException (new 
UnableToCutDataSourceDirectoryElementException (exception) ) ; 
completed = false; 

} 

return completed; 

) 

/** 

* Delete a directory element . 

* ©param folderNode - ITreeFolderNodeModel - folder to delete from 
public boolean deleteNode ( ITreeFolderNodeModel folderNode) { 

boolean completed = true; 
try { 

getDataSourceDirectoryModel ( ) . removeNode ( (DataSourceDirectoryNodeModel) getDataS 
ourceDirectory () .getSelectedNode () ) ; 

getDataSourceDirectory 0 . refresh (> ; 

updateViewO ; 
} catch (Exception exception) { 

f ireDbResultsException (new 
UnableToDeleteDataSourceDirectoryElementException (exception) ) ; 
completed = false; 

} 

completed; 
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} 

* Edit a Data Source. 

* <p> 

* ©return completed - boolean - success indicator 
*/ 

public boolean editDataSource ( ) { 

boolean completed = true; 

Object node = null; 
try { 

node = getDataSourceDirectory 0 .getSelectedDataSourceNode 0 ; 
} catch (Exception exception) { 

} 

if (node instanceof DataSourceDirectoryDataSourceNodeModel) { 
try { 

editDataSource ( (DataSourceDirectoryDataSourceNodeModel) node) ; 

updateViewO ; 
} catch. (DVException exception) { 

f ireDbResultsException(new NoDataSourceSelectedException ( ) ) ; 
completed = false; 

) 

} else { 

f ireDbResultsException(new NoDataSourceSelectedException () ) ; 
completed = false; 

} 

completed; 



* Bring up a dialog containing a new data source information panel. 

■ DataSourceDirectoryDataSourceNodeModel - data 

jr'ivate void editDataSource (DataSourceDirectoryDataSourceNodeModel dataSourceNode) 
throws DVException { 



tifyOperationBegunC'Edit Data Source" + dataSource . getModelNar 



"Edit Existing Data Source Informatio 
+ "\"" + dataSource. getModelName 0 



dataSourceNode . setTreeDataSource (customizer .getJCTreeData { ) > 
getDataSourceDirectory () . invalidate ( ) ; 

lishedC'Edit Data Source" + 



notifyOperationCanceledC'Edit Data Source" + 
dataSource . getModelName 0 ) ; 
} 

* Edits a data source folder node. 



* Bring up a dialog containing a new connection information panel. 

* <P> 

* ®param folderNode - DataSourceFolderModel - folder to edit 
private void editDataSourceFolder (DataSourceFolderModel folderNode) { 



notifyOperationBegunC'Edit Data Source Folder" + f olderNode . getName ( ) ) ; 

int selection = VCOptionDialog.sliowOptionDialog( 

this, 
//parent Component 

existingDataSourceFolderPanel. update ( f olderNode ) , //message - object to 

display 

"Edit Connection Information for " + "\"" + f olderNode . getNaine ( ) + 
"\"", //title - title string for the dialog 

VCOptionDialog.DEFAULT_OPTION, //optionType - 

YES_NO_OPTION or YES_NO_CANCEL_OPTION 

VCOptionDialog.QUESTION_MESSAGE, //messageType - ERROR_MESSAGE , 

INFORMATION_MESSAGE, etc 

null, //icon - 

icon to display in the dialog 

EditElementOptionNames, //options - array 

of possible choices 

EditElementOptionMames [1] ) ; //initialValue - object 

that is the default selection 



if (selection == VCOptionDialog.OK_OPTION) { 
setvisible (true) ; 

existingDataSourceFolderPanel. getEditorO .setFolderO ; 

notifyOperationFinished ( "Edit Data Source Folder" + 
f olderNode .getName ( ) ) ; 
} else { 

notif yOperationCanceled ( "Edit Data Source Folder" + 
f olderNode . getName () ) ; 
} 

} 



* Edits a data source folder node. 

* <p> 

* Bring up a dialog containing a new data source information panel . 
*/ 

public boolean editFolderO { 

boolean completed = tjrue; 
f ireClearDesktopStatus 0 ; 

Object node = getOataSourceDirectory ( ) .getSelectedDataSourceFolder ( ) ; 

if (node instanceof DataSourceFolderModel) { 

editDataSourceFolder ( (DataSourceFolderModel) node) ; 

updateViewO ; 
} else { 

f ireDbResultsException(new NoDataSourceFolderSelectedExceptionO ) ; 
completed = false; 

} 

return completed; 

} 

/** 

* Fetch the list of actions supported by this launcher. 

* ©return the list of actions supported by the embedded JTextComponent 

* augmented with the actions defined locally. 
*/ 

public Action [] getActionsO { 

Action [] defaultActions = { 

new EditDataSourceFolderAction(this) , 
new AddDataSourceFolderAct ion (this) , 

new EditDataSourceAction(this) , 
new AddDataSourceAct ion (this) , 



new NewDataSourceDirectoryAct ion (this) , 
new OpenDataSourceDirectoryAction (this) , 
new SaveDataSourceDirectoryAction (this) , 
new SaveAsDataSourceDirectoryAction (this) 
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new CopyDataSourceDirectoryEleraent Act ion (this) , 
new CutDataSourceDirectoryElementAction (this) , 
new DeleteDataSourceDirectoryElementAction (this) , 
new PasteDataSourceDirectoryElementAction(tliis) , 

//new VPCommandConnectionTogglePreviewingOf ComiectionsActit 
new ToggleSiiowAsDataSourceDbResultsAction(tliis) , 



TextAction-augmentList (super .getAct ions () , def aultActions) ; 
I 

/** 

* Gets tlie Data Source Customizer. 
*/ 

public VPDataSourceCustoraizer getDataSourceCustomizer ( ) { 

throw new DVShouldNotBeReachablelnternalError (this) ; 

} 

/** 

* Gets the Data Source Directory view. 

* <p> 

* @return dataSourceOirectory - DataSourceDirectory 
*/ 

public DataSourceDirectory getDataSourceDirectory ( ) { 

( (DataSourceDirectoryView) getview 0 ) .getDataSourceDirectory { ) ; 



* Gets the Data Source Directory. 

* <p> 

* ©return directory - DataSourceDirectoryModel 
*/ 

public DataSourceDirectoryModel getDataSourceDire 



/** 

* Gets the Explorer Directory view. 

* <p> 

* ©return explorerDirectory - ExplorerDirectory 
*/ 

public ExplorerDirectory getExplorerDirectory () { 
return getDataSourceDirectory ( > ; 

} 

/* 

* Gets the folder that owns this data source . 

* <p> 

* ©return folder - DataSourceDirectoryFolderNodeModel 
*/ 

public DataSourceDirectoryFolderNodeModel getFolderNodeOf SelectedDataSource () 



(DataSourceDirectoryFolderNodeModel) getDataSourceDirectory () . getFolderNodeOf SelectedDa 



' Gets a message using 
' <p> 

■ ©return message = String 
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piiblic String getMessageUsingResource (String key) { 

return getMessageUsingResourceC", getResourcesName () , getResources ( ) , key, 

} 

/** 

* Gets the type name of the node (e.g.. Portal, Data Source) managed by the 
controller. 

* <p> 

* ©return nodeTypeMame - String 
*/ 

p\iblic String getNodeTypeName () { 
"Data Source"; 



/** 

* Gets the exception for "no folder selected" . 

* <p> 

* ©return exception = DVException 

public DVException getNoFolderSelectedExceptionO { 

return new NoDataSourceFolderSelectedException ( ) ; 



* Answer if dataSources are to be previewed. 

* <p> 

* ©return previewingOf Connections - boolean 
public boolean getPreviewingOf DataSources () { 

1 previewingOf DataSources; 



} 



' Gets the selected Data Source from the directory 
' <p> 

' @param selectedDataSource = MDbNodeTreeData 



piiblic MDbNodeTreeData getSelectedDataSource ( ) 
throws DVException { 



getDataSourceDirectory ( ) .getSelectedDataSource () ; 



* Gets the selected Data Source Folder from the directory. 

* <p> 

* ®param selectedFolder = MDbNodeTreeData - return null if no Data S 

public DataSourceFolderModel getSelectedDataSourcePolder ( ) { 

return getDataSourceDirectory ( ) .getSelectedDataSourcePolder () 

} 

/** 

* Answer if the Data Source is to be displayed. 

* <p> 

* ©return showAsDbResults - boolean 
*/ 

public boolean getShowAsDbResults ( ) { 
return showAsDbResults ; 

} 



* Gets the Tree Directory Model. 

* <p> 

* ©return directoryModel - TreeDirectoryModel 
*/ 

public TreeDirectoryModel getTreeDirectoryModel C) { 
return getDataSourceDirectoryNodel () ; 

} 



/** 

* Initializes. 

* <p> 

* ©return success - boolean 
*/ 

public boolean initialize {) { 

initialize ( "DataSourceDirectoryController" , new DataSourceDirectoryViewO ) ; 

getDataSourceDirectory 0 .addTreeSelectionListener (new 
DataSourceDirectorySelectionListener (this) ) ; 

getDataSourceDirectory { ) . expandRow ( 1 > ; 

existingDataSourceFolderPanel = new ExistingDataSourceFolderWizard{this) ; 
newDataSourceFolderPanel = new NewDataSourceFolderWizard(this) ; 



/** 

* Answers true if a dialog is active. 

* <p> 

* ©return dialogActive - boolean 
*/ 

public boolean isDiaglogActive () { 
return dialogActive; 

} 



* Launches the help facility for this viewer's context. 
*/ 

pviblic void launchViewerContextHelp ( ) { 

launchViewerContextHelpUsing ( "dataSourceDirectoryController" ) ; 

} 



* Creates a new Data Source Directory. 

* <p> 

* ©return success - boolean 
*/ 

piiblic booleain newDirectory {) { 
boolean completed = true; 
try { 

DataSourceDirectoryModel .getSessionModel ( ) . setNewModel ( ) ; 

updateView ( ) ; 
} catch (Exception exception) { 

f ireDbResultsException (new 
UnableToNewDataSourceDirectoryException (exception) ) ; 
completed = false; 

} 

return completed; 

} 
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* Opens a "saved" data source directory. 

* <p> 

* ©return success - boolean 
*/ 

public boolean openDirectory ( ) { 
boolean completed = true; 
File file = getFileToOpen ( ) ; 
try { 

if {file != null) { 

DataSourceDirectoryModel .getSessionModel ( ) .openModelln(f ile) ; 

updateViewO ; 

} 

} catch (Exception exception) { 

f ireDbResultsException (new 
UnableToOpenDataSourceDirectoryFileException (exception) ) ; 
completed = false; 

} 

return completed; 

} 



* Pastes a directory node. 

* <p> 

* ©return success - boolean 
*/ 

public boolean pasteNode ( ITreeFolderNodeModel folderNode) { 
boolean completed = trxie; 
try { 

getDataSourceDirectoryModel () .pasteClipBoardNodeTo ( (DataSourceDirectoryPolderNo 
deModeDgetDataSourceDirectory 0 .getFolderNodeOfSelectedDataSource (> ) ; 

getDataSourceDirectory 0 . invalidate ( ) ; 

updateViewO ; 
} catch (Exception exception) { 

f ireDbResultsException (new 
UnableToPasteDataSourceDirectoryElementException (exception) ) ; 
completed = false; 

} 

return completed; 

} 

/** 

* Save As the data source directory. 

* <p> 

* ©return success - boolean 
*/ 

public boolean saveAsDirectory () { 
boolean completed = true; 
File file = getFileToSave ( ) ; 
try { 

if (file != null) 

DataSourceDirectoryModel .getSessionModel ( ) . saveAs (f ile) ; 
} catch (Exception exception) { 

f ireDbResultsException (new 
UnableToSaveAsDataSourceDirectoryException( exception) ) ; 
completed = false; 

} 

return completed; 

} 
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* Saves the data source directory. 

* <p> 

* ©return success - boolean 
*/ 

public boolean saveDirectory ( ) { 
boolean completed = true ; 
try { 

DataSourceDirectoryModel .getSessionModel () . 

updateViewO ; 
} catch (Exception exception) { 

f ireDbResultsException (new 
UnableToSaveDataSourceDirectoryFileException (exception) ) ; 
completed = false; 

} 

return completed; 

} 

* Sets that a dialog is active . 
*/ 

public void setDialogActive () { 
dialogActive = true; 



/** 

* Sets if dataSources are to be previewed. 

* <p> 

* ©return previewingOf Connections - boolean 
*/ 

public void setPreviewingOf DataSources (boolean mode) { 
previewingOf DataSources = mode; 

} 

* Sets if the Data Source is to be displayed. 

* <p> 

* ©return showAsDbResult s - boolean 
*/ 

public void setShowAsDbResults (boolean mode) { 
showAsDbResults = mode; 



* Brings up a modal dialog with a specified icon, where the initial 

* choice is dermined by the <code>initialValue</code> parameter and 

* the number of choices is determined by the < code >optionType</c ode > 

* <p> 

* If <code>optionType</code> is YES_NO_OPTION, or YES_N0_CANCEL_0PTI01 

* and the <code>options</code> parameter is null, then the options arf 

* supplied by the look and feel . 



* oparam parentComponent Determines the Frame in which the dialog is displayed 

* If null, or if the parentComponent has no Frame, a 

* default Frame is used. 

* oparam message The Object to display 

* ®param title the title string for the dialog 

* ®param optionType an int designating the options available on the dialog: 

* yES_NO_OPTION, or YES_NO_CANCEL_OPTION 

* Oparam messageType an int designating the kind of message this is, 

* primarily used to determine the icon from the pluggable 

* look and feel: ERROR_MESSAGE , IKFORiyiATION_MESSAGE, 

* WARNIHG_MESSAGE, QUESTION_MESSAGE , or PLAIH_MESSAGE . 
m the icon to display in the dialog 
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* ©param options an array of objects Indicating the possible choices 

* the user can make. If the objects are components, they 

* are rendered properly. Non-String objects are 

* rendered using their <code>toString</code> methods. 

* If this parameter is null, the options are determined 

* by the look and feel . 

* @param initialValue the object that represents the default selection 

* for the dialog 

* ©return an int indicating the option chosen by the user, 

* or CLOSED_OPTION if the user closed the Dialog 
*/ 

public VPDataSourceCustoraizer showDataSourceWizardDialog (boolean isNewConnection, 
String dialogTitle) { 

//allow only one dialog occurence 
if (isDiaglogActiveO ) 
return null; 

setDialogActive ( ) ; 

Beans. setDesignTime (true) ; 

lew VPDataSourceCustoraizer (this, 

int choicelndex = VCOptionDialog. showOptionDialog ( 

this, 
/ / parentComponent 

customizer, //message - 

object to display 

dialogTitle, //title - title 

string for the dialog 

VCOptionDialog. DEFAaLT_OPTION, //optionType - 

YES_NO_OPTION or YES_NO_CANCEL_OPTION 

VCOptionDialog. QUESTION_MESSAGE, //messageType - ERROR_MESSAGE , 

INFORMATION_MESSAGE, etc 

null, //icon - 

icon to display in the dialog 

DataSourceOptiohNames, //options - array of 

possible choices 

DataSourceOptionNames [1] ) ; //initialValue - object 

that is the default selection 

Beans . SetDesignTime (false) ; 

clearDialogActiveO ; 

if (choicelndex == VCOptionDialog . OK_OPTION) 
else 



null; 



* Updates the datasource directory view. 
*/ 

public void updateViewO { 

( (DataSourceDirectoryView)getView() ) .getDataSourceDirectory ( ) .updateViewO ; 

} 

* Previews the database of the data source. 

* <p> 

* @param dataSource - the Data Source to preview 
*/ 

public void viewDataSource (MDbNodeTreeData dataSource) { 

traceMessage (getClass {) + " >> viewDataBaseConnection" ) ; 

fireClearDesktopStatus 0 ; 

if (getPreviewingOfDataSources () ) { 
if (! getShowAsDbResultsO ) { 

// just reuse exiting preview frame and preview listener 
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f irePropertyChange ( "Connection Available", null, dataSource) ; 
} else { 

// do not reuse preview frame plus get PreviewingOf Connections ( 

state does not matter 

firePropertyCliange( "Connection Available", null, dataSource); 

} 

} 
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Right-Click for Help 

package com . dcr . dve . view . vcomponent 
* @(#)IVCMenuItem.java 



lerface for VCMenuItem components. 

* <p> 

* ©author Edward L. Stull 

* ©version 1 . 1 

* ©since JDK 2 
*l 

//3 456 78901234 56789012345578901234567890123456789*12345678901234567890123456 7890 



import j avax . swing . I con ; 

import j avax .swing . MenuEl eraent ; 

import javax. swing .MenuSelectionManager; 

import com . dcr . dve . view . vcomponent . vccontrol . IVCCHelp ; 

public interface IVCMenuItem extends IVCCHelp { 
/** 

* Adds an Action listener 

* <p> 

* @param listener - ActionListener 
*/ 

piiblic void addActionListener (ActionListener listener); 

* <I 

* ©see #getMenuIter 



* Overrides the processing of the event modifiers. 

* <p> 

* Process a mouse event . event is a MouseEvent with, source being the j 
component . 

* componentPath is the path of the receiving MenuElement in the mem 

* hierarchy, manager is the MenuSelectionManager for the menu hiera: 

* This method should process the MouseEvent and change the menu select 
necessary 

* by using MenuSelectionManager ' s API. 

* <p> 

* Note: you do not have to forward the event to sub-components. This ; 

* by the MenuSelectionManager 
*/ 

public void processMouseEvent (MouseEvent event, MenuElement path[], 
MenuSelectionManager manager) ; 

/** 

* Sets the Action Command 

* <p> 

* (Sparam commandName java . lang . String 
*/ 

pioblic void setActionCommand (String commandName); 
/** 

* Sets the enable mode. 

* <p> 

* ®param mode boolean 



public void setEnabled (boolean mode) ; 



* Sets the laorizontal text position 

* <p> 

* ©paratn alignment - int 
*/ 

public void setHorizontalTextPosition (int alignment); 



* Sets the : 



* @param icon - Icon 
*/ 

public void setlcondoc 



* @param keyAccelerator - int (char) 
*/ 

public void setMnemonic ( int keyAccelerator); 

* Sets the text. 

* <p> 

* ®param text java. lang . String 
*/ 

public void setText (String text); 



package com . dcr . dve - view . vcomponent 
/** 

* ®(#)IVCCHelp. java 



* IVCCHelp provides a common interface for help-related components. 

* <p> 

* @author Edward L. Stull (ID: ELS) 

* ©version 2.006 

* ©since JDK 2 
*/ 

//345S78901234567a90123456789012345S789012345S789*1234567890123456789012345S7890 
import j ava . awt . event . MouseEvent ; 



public interface IVCCHelp { 
/** 

* Gets the name of the command. 

* <p> 

* sretiirn name java. lang .String 
*/ 

public String getCommandName ( ) ; 

* Gets the default name of the command. 

* <p> 

* ©return name java. lang. String 
*/ 

public String getDef aultName ( ) ; 



* Gets the string associated with the resource tag. 



* @param name java . lang. String 

* ©return name j ava . lang . String 
*/ 

piiblic String getResourceString (String resourceTagName) ; 



package com. dcr .dve .view. -v-component . vccontrol ; 
* @(#)VCControlKit. java 



* An <code>VCControlBar</code> is a set of helper methods supporting 

* the operation of controls, that is, active components. Currently, this 

* kit provides context help support in menu and toolbar controls . 

* <p> 

* ©author Edward L. Stull 

* aversion 2 . 11 

* ©since JDK 2 
*/ 

//345S78 9012345678 901234557890123456 7890123456 789*12345 578901234 5678 901234567 890 
import j ava . awt . event . MouseEvent ; 



import com . dcr . dve . view . vcomponent . vchtml . VCDef aultBrowser ; 

public class VCControlKit extends Object { 
/** 

* Gets the URL text for the contextual help name. 

* <p> 

* @param helpTag - a resource tag for help 

* ©return contextHelpUrlName 
*/ 

public static String getContextHelpUrlLabelFor (String helpTag) { 
return helpTag + getContextHelpUrlLabelSuf f ix () ; 

} 

* Gets the label for the contextual help URL. 

* <p> 

* ©return contextHelpUrlLabel 
*/ 

public static String getContextHelpUrlLabelSuf fix { ) { 
"HelpUrl" ; 



* ©param helpview - a view that implements the help interface 

* ©return contextHelpUrlText 
*/ 

public static String getContextHelpUrlTextFor ( IVCCHelp helpView) { 

return helpView. getResourceString (helpView . getCommandName ( ) 
getContextHelpUrlLabelSuffixO ) ; 
} 



* Answer if this is a help context event . 

* <p> 

* Oparam event - the mouse event . 

j ava . awt . event . MouseEvent 
j ava . awt . event . MouseLi stene: 
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* @see java.awt.ComponentttaddMouseListener 

* ®see java.awt. Component ienableEvents 
*/ 

public static boolean isContextHelpEvent (MouseEvent i 



== MouseEvent .MOUSE_RELEASED) 

int.getModifiers 0 & MouseEvent .META_MASK) != 0) ) ; 



* Launch the help facility for a view that implements 

* the help interface. 

* <p> 

* Oparam helpview - a view that implements the help interface 
public static void launchViewerContextHelpUsing (IVCCHelp helpView) { 

String def aultHelpUrlText = getContextHelpUrlTextFor (helpView) ; 

String fileSep = System .getProperty ( "file . separator" ) ; // e.g.. 

String helpUrlPath = System. getProperty ("user. dir") + fileSep + 
f ileSep; 

VCDefaultBrowser browser = new VCDef aultBrowser ( ) ; 
if (defaultHelpUrlText == null) 

browser .displayURL(helpUrlPath + "Action" + fileSep + 
helpView . getDefaultUame (). replace ( ' ', '_') + ".htm"); 

browser. displayURL,(helpUrlPath + defaultHelpUrlText); 

} 

* Launch the help facility for this viewer's context using a help URL t 

* <p> 

* Oparam helpUrlText - String 

public static void launchViewerContextHelpUsing (String helpUrlText) { 



String fileSep = System. getProperty (" file . separator" ) ; // e.c 

VCDef aultBrowser browser = new vCDefaultBrowser () ; 
browser. displayURL{ System. getProperty ("user. dir") + fileSep ^ 
- helpUrlText) ; 



package com. dcr.dve. view. 
* @(#) VCToolBarButton. ja\ 



' An implementation of a button for the viewer toolbars. 
' <p> 

' ©author Edward L. Stull 



//34567890123456789012345678901234567890123456789+12345S789012345678901234567890 

: . MouseEvent ; 
import java.net, URL; 
import java.util .Hashtable; 
import java. util .ResourceBundle; 

import j avax . swing . Imagelcon ; 

import j avax . swing . border . Border ; 

import j avax . swing . border . CompoundBorder ; 



import j avax . swing . border . EmptyBorder ; 
import j avax . swing . border . Et chedBorder ; 



import com.dcr .dve . view.vcomponent . VCAction; 
import com . dcr . dve . view . vcomponent . VCPushButton; 
import com . dcr . dve . view . vcomponent . vcbutton . VCButton ; 
import com . dcr . dve . view . vcomponent . vccontrol . IVCCHelp ; 
import com . dcr . dve . view . vcomponent . vccontrol . VCControlKit ; 
import com . dcr . dve . view . vcomponent . vchtml . VCDef aultBrc 



import com. dcr . dvg . model . ResourcesKit ; 

public class VCToolBarButton extends VCPushButton implements IVCCHelp { 

protected VCToolBar controller = null; // the controller for this component 
protected String defaultName; 

protected String tagName; // name used for tag in the resource 
protected Imagelcon imagelcon; 

protected final static Border emptyBorder = new EmptyBorder (2 , 2, 2, 2); 
protected final static Border etchedBorder 

= new CompoundBorder (new EtchedBorder {) , emptyBorder) ; 



public VCToolBarButton (VCToolBar controller. String tagName) 
super ( ) ; 

initialize (controller, tagName) ; 

} 

/** 

* Launchs the help facility for this viewer's context. 
*/ 

pviblic void contextHelpAction { ) { 

VCControlKit . launchViewerContextHelpUsing (this) ; 

} 

/** 

* Gets the action for the specified command. 

* <p> 

* ®param String - command 
*/ 

protected VCAction getAction (String command) { 

return (VCAction) getCommands ( ) .get (command) ; 

) 

/** 

* Gets the action suffix string. 

* <p> 

* ©return image - suffix 
*/ 

public String getActionSuf f ix ( ) { 

return getController ( ) .getActionSuf fix ( ) ; 

} 

/** 

* Gets Y alignment. 

* <p> 

* ©return alignment 
*/ 

public float getAlignmentY ( ) { 
} 
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^* Gets the action name for the menu item as specified in the resource. 

* <p> 

* ©param String- command 

protected VCAction getButtonAction (String commandName) { 

String actionName = getResourceString (commandName + getActionSuff ix ( ) ) ; 

if (actionName == null) 

actionName = commandName; //defalut action name to that of the command 

getAction (actionName) ; 



* Gets the name (that is, tag name) for the buttom that is used by the i 

* <p> 

* ©return tagName - java.lang.String 
*/ 

public String getCoramandName ( ) { 
1 tagName; 



^ * Gets the commands of the controller. 

* <p> 

* ©return commands - java.util .Hashtable; 
piablic Hashtable getComraands { ) { 

return getController ( ) . get Commands 0 ; 

} 

^ * Gets the controller for this resource-employing component. 

* <p> 

* ©return controller - the VCToolBar controller 
public VCToolBar getController ( ) { 

return controller; 

) 

^ * Gets the name for the buttom that is used by the resource. 

* <p> 

* ©return defaultName - String 
piiblic String getDef aultName () { 

return defaultName; 

} 

/** 

* Gets the image (icon) based on the image name. 

* <p> 

* ©param imageName java.lang.String 

public Imagelcon getlmagelcon (String imageName) { 

getController 0 . getlmagelcon ( imageName) ; 
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* Gets the image suffix string. 

* <p> 

* Oreturn imageSuffix - String 
*/ 

public String getlmageSuf f ix ( ) { 

return getController ( ) . getlmageSuf fix ( ) ; 

} 

/** 

* Gets the label suffix string. 

* <p> 

* ©return labelSuffix - String 
*/ 

public String getLabelSuf f ix() { 

return getController { ) .getLabelSuf fix ( ) ; 

} 



public URL getResource (String key) { 

1 getController 0 .getResource (key) ; 



* Gets the resources. 

* <p> 

* ©return ResourceBundle 

public ResourceBundle getResources ( ) { 

return getController () .getResources ( ) ; 

} 



. resource string from the local resource or from a super class resource. 



public String getResourceString (String key) { 

return getController ( ) . getResourceString (key) ; 

} 

/** 

* Gets the image suffix string. 

* <p> 

* ©return tipSuffix - String 
*/ 

public String getTipSuf f ix() { 

1 getController () .getTipSuf fix () ; 



} 



* Initializes the menu item and register the result with the 

* hashtable so that it can be fetched with getMenuItemO . 

* <p> 

* Oparam controller 

* @param tagName name used for tag in the resource 

* ©see ttgetMenuItem 

public. void initialize (VCToolBar controller. String tagName) [ 



setController (controller) ; 



setUI {) ; 

setCommandNarae (tagName) ; 
setLabelFromResource ( ) ,- 
setCrossAct ionAndBut t onRegi e 
setlmageFromResource 0 ; 
setToolTipText () ; 



* Answer if the icon is to be shown. 
*/ 

public boolean isShowIconO { 



* Override to process the event modifiers. 

* <p> 

* Processes mouse events occurring on this component by 

* dispatching them to any registered 

* <code>MouseListener</code> objects. 

* <p> 

* This method is not called unless mouse events are 

* enabled for this component . Mouse events are enabled 

* when one of the following occurs : 

* <li>A <code>MouseListener</code> object is registered 

* via <code>addMouseListener</code> . 

* <li>Mouse events are enabled via <code>enableEvents</code> . 

* </ul> 

* @param event - the mouse event . 
: . event . MouseEvent 
; .event .MouseListener 
: . Component#addMouseListener 
: . Component #enableE vents 

TOid processMouseEvent (MouseEvent event) { 

if (VCControlKit . isContextHelpEvent (event) ) 

VCControlKit . launchViewerContextHelpUsing (this) ; 
//( (MouseListener) mouseListener. a) .model . setPressed ( falsf 
/ /mouseListener .model . setPressed (false) ; 



super .processMouseEvent (event) ; 



* Sets the name for the buttom that is used by the resource. 

* <p> 

* @param tagName 

public void setCommandName (String tagName) { 
this. tagName = tagName; 

} 

* Sets the controller for this resource-employing component. 

* <p> 

* @param controller - the VCToolBar controller 
public void setController (VCToolBar controller) { 

this. controller = controller; 

} 



* Cross registers the action and menu item. Also, map 

* the command name to this menu item. 

public void setCrossActionAndButtonRegistrationO { 

String commandName = getCommandUame ( ) ; 

VCAction action = getButtonAction {commandHame) ; ■ 

if (action == null) 

action = getButtonAction (getDefaultName () ) ; 

if (action 1= null) { 

// set the action commnand name that is included m the event sent 
action listeners 

setActionCommand( (String) act ion . getValue (action. NAME) ) ; 
addActionListener (action) ; 
setEnabled (action. isEnabledO > ; 
setlcon (action. getlconO ) ; 

act ion . addPropertyChangeList ener ( new VCToolBarButt onList ener ( this ) ) 
} else { 

setEnabled (false) ; 

/*debug trace*///System. err . println( "Action for button \"" + 
commandName + "\" not resolved."); 

ResourcesKit . f ireResourceTagError (getResources ( ) , getDefaultName ( ) ) 

} 



* Sets the default name for the buttom. 

* <p> 

* ®param defaultName 
*/ 

public void setDefaultName (String defaultName) 
this. defaultName = defaultName; 



* Sets the button's image. 

public void setlraageFromResource ( ) { 

if (getlconO == null) { // if not specified by the action 
String commandHame = getCommandName { ) ; 

URL url = getResource (commandName + get ImageSuf f ix ( ) ) ; 
if (url != null) { 

if (isShowIconO ) 

setHorizontalTextPosition (VCButton. CENTER) ; 

setHorizontalText Posit ion (VCButton. LEFT) ; 

setlcon (new 

ImageIcon(java. awt. Toolkit. getDefaultToolkit 0 .getlmage (url) ) ) ; 
} else 

// default to image with the command name 
setlcon (getlmagelcon (getDefaultName 0 ) ) ; 



* Sets the menu item's label in the menu list. 

* ©param command name 

protected void setLabelFroraResource { ) { 

String commandName = getCommandName () ; 

String label = getResourceString (commandName + getLabelSuf f ix ( ) ) ; 



//defalut the label 
if (label == null) 

label = getResourceString (comraandName + getActionSuf f i: 
if (label == null) 

label = commandtlame; 

//setText (label) ; 
setDefaultName (label) ; 



/** 

* Answer if 1 



public boolean setShowIct 



} 



•erride text set to only set the name 

* ©parain buttonText - String - the text to display with the button 
pijblic void setText (String buttonText) { 



* Sets the tool tip text based on the resource specification, 
protected void setToolTipText 0 { 

String tip = getResourceString (getCommandName () + getTipSuffi: 
if (tip != null) 

super . setToolTipText (tip) ; 

super . setToolTipText (getDef aultName ( ) ) ; 



* Sets UI for this component . 
*/ 

public void setUI ( ) { 

setMargin(new Insets (1, 1 , 1 , 1) ) ; 

Border emptyBorder = new EmptyBorder (1 , : 
setBorder (emptyBorder) ; 

setRequestFocusEnal>led( false) ; 

} 
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Transcripts 

package com . dcr . dvg .model . transcript ; 
/** 

* ® (#) Transcript . java 



; models of 

jgged events that potentially can be edited. 

* <p> 

* ©author Edward L . Stull 

* ©version 1.0.2 

* ©since JDK 2 
*/ 

//34567890123456789012345678901234567890123456789*12345678 90123456789012345( 

import java.util .Date; 

import j avax . swing . text 
import j avax . swing . text 

import com . dcr . dve . model . muser . MUserContext ; 
import com . dcr . dvg. model .DvgProductInf o; 

public class Transcript extends Def aultStyledOocument { 

protected String dvgVersion = null; 
protected String userld = null ; 
protected Date creationDate = null; 
protected Date lastEditedDate = null; 

* Transcript constructor, 
public Transcript () { 

this (new StyleContext ( ) ) ; 



/** 

* Constructor based on a set of styles. 

* <p> 

* (gparam styles - StyleContext 
*/ 

public Transcript (StyleContext styles) { 
super (styles) ; 

setUserld {MUserContext. getUserldO ) ; 
setDvgVersion (DvgProductInf o .getDvgVersic 
setCreationDate (new DateO ) ; 
setLastEditedDate (new DateO ) ; 



treat ion date. 
sationDate Date 
iblic Date getCreationDate () { 
return creationDate; 

^ Gets the version, 
t <p> 

" ©return version j ava . lang . String 
iblic String getDvgVersion { ) { 



* Gets the date of the last edit. 

* <p> 

* ©return java.util .Date 
*/ 

public Date getLastEditedDate () { 
return lastEditedDate; 

} 

/** 

* Gets the user's ID. 

* <p> 

* ©return userld - j ava . lang . String 
*/ 

public String getUserldO { 
return userld; 

} 

/** 

* Sets the creation date. 

* <:p> 

* ®param creationDate java.util .Date 
*/ 

private void setCreationDate <Date creationDate) { 
this .creationDate = creationDate; 

} 

/** 

* Sets the version. 

* <p> 

* ©param dvgVersion j ava. lang . String 
*/ 

private void setDvgVersion (String dvgVersion) { 
this. dvgVersion = dvgVersion; 

} 

/** 

* Sets the date of the last edit . 

* <p> 

* ®param lastEditedDate java.util .Date 
*/ 

private void setLastEditedDate (Date lastEditedDate) 
this. lastEditedDate = lastEditedDate; 

} 

/** 

* Sets the user's ID. 

* <p> 

* @param userld j ava. lang. String 
*/ 

private void setUaerld (String userld) { 
this. userld = userld; 



package com . dcr . dvg . model . transcript ; 
/** 

* @(#)MasterTranscript. java 
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* The class <code>MasterTranscript</code> is a read-only model of logged events. 

* It is opened, updated and saved under system control. It cannot be edited by 

* <p> 

* ©author Edward L. Stull 

* ©version 1 . 2 

* ©since 2 
*/ 

//34567890123456789012345S7890123456789012345S7S9*1234567a9012345678901234567890 

import j avax . swing . text . StyleContext ; 

public class MasterTranscript extends Transcript { 

* Constructor. 
*/ 

public MasterTranscript ( ) { 



* Oparam styles j avax . swing . text . StyleContext 
V 

public MasterTranscript (StyleContext styles> { 
super (styles) ; 

} 
} 

package com . dcr . dvg . view . controller . transcript ; 

* @ (#) TranscriptController. java 



* The class <code>TranscriptController</code> controls, that is manages, 

* all transcripts, one of which is a read-only master transcript and 

* the other are optionally- created user-editable 1 

* <p> 

* ©author Edward L. Stull 

* ©version 1.8 

* ©since JDK 2 
*/ 

//3456789012345S78901234 5678901234567890123455789*123456' 

import 
import 
import 
import 
import 



012345S78901234567890 



awt . event . Act ionEvent ; 
beans . PropertyChangeEvent ; 
io . lOException; 
util.Date; 



import j avax . swing . Act ion ; 
import j avax . swing . JLayer edPane ; 
import j avax . swing . text . JTextComponent ; 
import j avax . swing . text . Text Act ion ; 

import com . dcr . dve . model . mdb . MDbNodeTreeData ; 

import com. dcr .dve .model .mcommand .mccompiler .mccparser.MCCCommand,■ 
import com. dcr .dvg. model . transcript . exception. CannotCloseMasterTranscriptExceptioi 
import 

com. dcr . dvg. model .transcript . exception. CannotSaveAPreviousMasterTranscriptExceptit 
import com . dcr . dvg .model . transcript . exception . CannotSaveAsMasterTranscriptExceptic 
import com.dcr.dvg.util .throwable.DVError; 
import com . dcr . dvg .util . throwabl e . DVExcept ion ; 

import com . dcr . dvg .util . throwable .MoDataSourceSelectedForQueryExecutionException; 
import com. dcr .dve .view. vcomponent .vctext . IVCEditor; 
import com. dcr .dve .view. vcomponent .vctext . VCRichTextEditor ; 
import com. dcr. dve. view. vcomponent .vctext . VCRichTextParagraph; 
import com. dcr .dve .view. vcomponent .vctext . VCRichTextRun; 



import cora.dcr .dve . vi< 
import 

com . dcr . dve . view . vpro< 



' . vproces s . vpauxil iaryact ion . VPAuxil iaryGeneralHelpAc t ion ; 
iss.vpcommand.vpcaction.VPCommandTranscriptControllerHelpActic 



import com. dcr. dve 
import 
com. dcr .dve 
import 
com . dcr . dve 
import 
com . dcr . dve 
import 



.ew . vproces s . vpcoramand . vpcact ion . VPCommandClearContextAct ic 



import 
import 



vprocess . vpcommand.vpcactic 
vprocess .vpcommand.vpcactic 
vprocess .vpcommand.vpcactic 
vpcommand . vpcactic 



vprocess .vpcommand.vpcactic 
1 . vprocess . vpcommand . vpcact ic 



i.VPCommandToggleAutoInsertContextAction; 
i.VPCommandToggleShowCommandParseAction; 
L - VPCommandToggleShowLexerParseAction ; 
..VPCommandToggleSuggestCommandContextActi 

. . VPCommandToggleValueFillContextAction ; 
. . VPCommandToggl eValuePaddedContextAct ion ; 



import com.dcr.dvg 
import com.dcr.dvg, 
import com.dcr.dvg, 
import 

com . dcr . dvg . model 



import I 
import I 
import I 
import ( 
import I 
import < 
import < 
import < 



m . dcr . dvg 
m . dcr . dvg 
m. dcr. dvg 
m . dcr . dvg 
m . dcr . dvg 
m . dcr . dvg 

m . dcr . dvg 



model . transcript .MasterTranscript ; 
model . transcript . Transcript ; 

model . transcript . exception. CannotCloseMasterTranscriptExoeptior 

;ranscript . exception . CannotSaveAPreviousMasterTranscriptExceptic 
model . transcript . exception . CannotSaveAsMasterTranscriptExceptic 
view . component . desktop . DVGDesktop ; 

view. component .text . rich. IRichTextFileEditorEmbedded; 

view. controller .datasource . DataSourceDirectory; 

view. controller . datasource . DataSourceDirectoryControllerFrame; 

view. controller . iteration . IterationControllerFrame; 

view . desktop . VPDesktopViewer ; 

view . desktop . DVGDesktopViewer ; 

view . desktop . StatusViewer ; 



3 TranscriptController extends VPRichTextEditorViewer | 



protected transient JLayeredPane desktopView = null; 
protected static String previousExecutedCommand 



11; 



public static final String CLEAR_DESKTOP_STATUS = "Clear Desktop 

public static final String OPERATION_BEGUN = "Operation Begun"; 

public static final String OPERATION_CANCELED = "Operation Canceled' 

public static final String OPERATION_FAILED = "Operation Failed"; 

public static final String OPERATION_FINISHED = "Operation Finished' 

piiblic static final String POST_ERROR = "Post Error"; 

public static final String POST_STATUS = "Post Status"; 

ptiblic static final String POST_WARNING = "Post Warning"; 



* FOR TESTING ONLY 

* FOR TESTING ONLY 

* FOR TESTING ONLY 

* FOR TESTING ONLY 
*/ 

public TranscriptController ( ) { 



setDesktopVie 



/ DVGDesktop ( ) ) ; 



* Constructor based on the desktop. 
*/ 

public TranscriptController ( JLayeredPar 
super ( ) ; 



desktopView) { 
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setDesktopView(desktopView) ; 
initialize 0 ; 

} 

/** 

* Clears the desktop status. 
*/ 

public void clearDesktopStatus () { 

getDesktopStatusViewer ( ) .clearStatus () ; 

} 



* Close. 
*/ 

piiblic void close C) 
throws DVException { 

/ / do nothing 

} 



* Closes the active transcript. 
*/ 

public void closeActionO { 
try { 

getTranscriptTabsViewer { ) . closeTranscript ( ) ; 
} catch (lOException exceptionl) { 

postWarningStatus (exceptionl .toStringO ) ; 
} catch {CannotCloseMasterTranscriptException exception2) { 

postWarningStatus (exception2 . toString ( ) ) ; 

} 

refresh 0 ; 

} 

/** 

* Launches a command execution of the command text. 

* <p> 

* Synchronized to maintain order of printing to the transcript. 

* <p> 

* @param commandText - String 
*/ 

public synchronized void executeCommand {String commandText) { 

traceMessage ( "starting parse with PREVIOUS commands=" + commandText); 

postOperationBegun ( "Executing " + commandText); 

MDbNodeTreeData selectedConnection = null; 
try { 

selectedConnection = getSelectedDataSource () ; 
} catch (DVException exception) { 
fireDVException (exception) ; 

} 

if (selectedConnection == null) { 
postDbResultsException (new 
NoDataSourceSelectedForQueryExecutionException ( ) ) ; 
} else { 

MCCCommand newParser = new MCCCommand ( ) ; 

// NOT YET IMPLEMENTED BELOW 

// frame is added to the desktop later 
// VPDesktopFrame newFrame = getDesktopViewer ( ) . getNewResultsFrame () ; 

// 

/ / newPar s er . addPr opertyChangeLi st ener ( newFrame ) ; 

/ / newParser . addPropertyChangeListener (this) ; 

// newFrame. addPropertyChangeListener (newParser) ; 

// 

/ / newFrame . f ireExecuteCommands ( commandText ) ; 



// 

} 



newFrame . refresh ( ) ; 

// NOT YET IMPLEMENTED ABOVE 



postOperationFinished ( "Executing " + commandText) ; 

} 

/** 

* Launches a command execution of the previous command. 
*/ 

public void executePrevious { ) { 

String commandText = getPreviousExecutedCommand ( ) ; 

if (commandText == null) 

commandText = getDef aultExecutionText () ; 

executeCommand (commandText) ; 

} 

* Laimches a command execution of the selected text. 
*/ 

public void executeSelection ( ) { 

String commandText = ( ( JTextComponent) getEditor ( ) ) .getSelectedText ( ) ; 
traceMessage (" starting parse with selection=" + commandText); 
setPreviousExecutedCommand (commandText ) ; 
executePrevious ( ) ; 

} 



/** 

* Gets the list of actions supported by this 

* editor. It is implemented to return the list 

* of actions supported by the embedded JTextComponent 

* augmented with the actions defined locally. 
*/ 

piablic Action [] getActionsO { 

Action [] default Act ions = { 

new VPCommandExecuteSelectionAction (this) , 
new VPCommandExecutePreviousAction (this) , 

new VPCommandClearContextAction (this) , 
new VPCommandToggleAutoInsertContextAction(this) , 
new VPCommandToggleSuggestCommandContextAction (this) , 
new VPCommandToggleValueFillContextAction (this) , 
new VPCommandToggleValuePaddedContextAction(this) , 

new VPCotranandToggleShowCommandParseAction (this) , 
new VPCommandToggleShowLexerParseAction(this) , 

new VPAuxiliaryGeneralHelpAction (this) , 

new VPCommandTranscriptControllerHelpAction (this ) 

}; 

return TextAction. augmentList (super .getActions () , default Act ions) ; 

} 



/** 

* Gets the active (i.e., one being edited) transcript viewer. 

* <p> 

* (Sparam transcriptviewer - TranscriptViewer 
*/ 

public Transcriptviewer getActiveTranscriptViewer ( ) { 

return ( (TranscriptTabsViewer)getView() ) .getActiveTranscriptViewer () ; 

} 
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* Gets the Data Source Directory (view) . 

* <P> 

* @param dataSourceDxrectory - DataSourceDirectory 

public DataSourceDirectory getDataSourceDirectory () { 

(DataSourceDirectory) 

{ (DataSourceDirectoryControllerFrame) 

getDesktopViewer ( ) . getDataSourceDirectoryControllerFrarae ( ! 
.getTypedViewer () .getDataSourceDirectory ( ) ; 



' Gets the default execution text, 
t <p> 

1 defaultExecutionText 



.>getDef aultExecutionText " 



* Gets the desktop status t 

* <p> 

* ©return statusViewer - StatusViewer 

public StatusViewer getDesktopStatusViewer ( ) { 

return 

( (DVGDesktopViewer) 

( (DVGDesktop)getDesktopView() ) . getController { ) ) 
getDesktopStatusViewer () ; 



* Gets the desk top view. 

* ©return desktopView - JLayeredPane 
public JLayeredPane getDesktopView ( ) { 

return desktopView; 

} 

/** 

* Gets the desktop viewer. 

* <P> 

* ©return desktopViewer - DVGDesktopViewer 
public DVGDesktopViewer getDesktopViewer ( ) { 

return (DVGDesktopViewer) ( (DVGDesktop) getDesktopView ( ) ) .getController () ; 

} 

^ * This a standard interface to access the transcript. 

* <p> 

* Gets the editor. 

* <p> 

* ©return editor - IVCEditor 
public IVCEditor getEditorO { 

return (IVCEditor) { (TranscriptTabsViewer) getView ( ) ) .getEditorO ; 



} 



* Gets the ; 
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* ©return controllerFrame - IterationControllerFrame 
*/ 

public IterationControllerFrame getlterationControllerFraTOe () { 
return ( CDVGDesktopViewer) 

( (DVGDesktop)getDesktopView() ) .getController () ) .getlterationControllerFrame ( ) ; 

} 

/** 

* Gets the previous executed command. 

* <p> 

* ©return previousExecutedCommand - String 
*/ 

public String getPreviousExecutedCottimand () { 
return previousExecutedCommand; 

} 



/** 

* Gets the selected Data Source from the Data Source directory. 

* <p> 

* ©param selectedDataSource - MDbModeTreeData 
*/ 

pTiblic MDblTodeTreeData get SelectedDataSource () 
throws DVException { 

return (MDbNodeTreeData) getDataSourceDirectory ( ) . getSelectedDataSource ( ) ; 

} 



/** 

* Gets the transcript at a designated index in the tab viewer. 

* <p> 

* ©return masterTranscript Transcript Viewer 
*/ 

public Transcript Viewer getTranscriptAt ( int index) { 

return ( (TranscriptTabsViewer) getview ( ) ) .getTranscriptAt (index) ; 

} 



* Gets the master transcript . 

* <p> 

* ©return masterTranscript VPCommandTranscriptBasic 
V 

public int getTranscriptCount {) { 

return ( (TranscriptTabsViewer) getView ( ) ) .getTranscriptCount ( ) ; 

} 



/** 

* Gets the transcript tabs viewer. 

* <:p> 

* ©return tabsViewer - TranscriptTabsViewer 
*/ 

public TranscriptTabsViewer getTranscriptTabsViewer ( > { 
return (TranscriptTabsViewer) getViewO ; 

} 

/** 

* Initializes this viewer. 
*/ 

public boolean initialize {) { 

initialize ( "TranscriptController " , new TranscriptTabsViewer (this) ) ; 
getSditorO .addPropertyChangeListener (this) ; 



} 
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* Answer true if the active transcript is a master transcript. 

* ©return answer - boolean 

piiblic boolean IsAMasterTranscript ( ) { 

return ( (TranscriptTabsViewer ) getview { ) ) . isAMasterTranscript ( ) ; 

} 

^* Launches the help facility for this viewer's context, 
public void launchViewerContextHelp ( ) { 

launchViewerContextHelpUsing ( "transcriptController" ) ; 

} 

* Creates and opens a new active transcript and file. 
*/ 

piiblic void newActionO { 

getTranscriptTabsViewer ( ) .newTranscript ( ) ; 
revalidate 0 ; 

} 

Opens and makes active an existing transcript and file, 
public void openActionO { 

getTranscriptTabsViewer { ) . openTranscript ( ) ; 
revalidate 0 ; 

} 

/** 

* Pastes rich text paragraph to the transcripts. 

* <p> 

* ®param richText Paragraph - VCRichTextParagraph 

public void pasteRichTextToTranscript (VCRichTextParagraph richTextParagraph) { 
getTranscriptTabsViewer () .pasteRichTextToTranscript (richTextParagraph) ; 

} 

* Pastes a VCRichTextParagraph to the transcripts. 

* <p> 

* ©parara text - String 

public void pasteToTranscript (VCRichTextParagraph richTextParagraph) { 

traceMessage{getClass() + " » pasteToTranscript=" + richTextParagraph) 
pasteRichTextToTranscript (richTextParagraph) ; 

} 

/** 

* Pastes an error to the transcripts . 

* <p> 

* ©parata error - DVError 

public void pasteToTranscript (DVError error) { 

traceMessage(getClass() + " » pasteToTranscript =" + error); 
pasteRichTextToTranscript (error. toRichTextParagraphO ) ; 
repaint ( ) ; 



} 



* Pastes an exception to the transcripts. 

* <p> 

* @param exception - DVException 

public void pasteToTranscript (DVException exception) { 

traceMessage (getClassO + " » pasteToTranscript=" + exception); 
pasteRichTextToTranscript (except ion. toRichTextParagraphO ) ; 
repaint ( ) ; 

} 

* Pastes text to the transcripts. 

* <p> 

* Oparam text - String 

public void pasteToTranscript (String text) { 

traceMessage{getClass{) + " » pasteToTranscript=" + text) ; 

VCRichTextRunList commandRunList = new VCRichTextRunList ( ) ; 
commandRunList . addFirst (VCRichTextRion . KEYWORD , text ) ; 

VCRichTextParagraph commandRunParagraph = new VCRichTextParagraph ( "command" , 
commandRunList) ; 

pasteRichTextToTranscript (commandRunParagraph) ; 

} 

/** 

* Posts "DB Results Exception" property change. 

* <p> 

* Localize this exception to this viewer. 

* <p> 

* ®param exception - DVException 

public void postDbRe suit sExcept ion (DVException exception) { 
postStatus (exception) ; 

} 

/** 

* Posts an error property change . 

* <p> 

* ®param errorMessage - DVException 

public void postErrorStatus (String errorMessage) { 

getDesktopStatusViewer ( ) .postErrorStatus (errorMessage) ; 
pasteToTranscript (errorMessage) ; 



* Posts the logoff operation. 
*/ 

public void postLogoff {) { 

clearDesktopStatus ( ) ; 

VCRichTextRunList commandRunList = new VCRichTextRunList 0 ; 
commandRunList. addLast (VCRichTextRun. HEADING, "Logoff at " ) ; 
commandRunList. addLast(VCRichTextRun. HEADING, new Date ( ) .toStringO) ; 

pasteRichTextToTranscript (new VCRichTextParagraph (" command" , commandRunLis 

getTranscriptTabsViewer () . close () ; 



/** 

* Posts the logon operation, 
piiblic void postLogon (String userNameText) { 
clearDesktopStatus ( ) ; 

VCRichTextRunList commandRunList = new VCRichTextR\inList { ) ; 
commandRunLi St. addLast(VCRichTextRun. HEADING, "Logon at ">; 
commandRunList . addLast (VCRichTextRun . HEADING, new Date ( ) . toString ( ) ) ; 
commandRunList. addLast(VCRichTextRun. HEADING, " by "); 

commandRunList. addLastCVCRicliTextRun.EMPHASIZEDKEYWORD, ": " + userNameText) , 
pasteRichTextToTranscript (new VCRichTextParagraph ( "command" , commandRunList)) , 



/** 

* Posts the beginning of an operation. 
*/ 

public void postOperationBegun (String operationName) { 
ClearDesktopStatus ( ) ; 

VCRichTextRunList commandRunList = new VCRichTextRunList () ; 
commandRunList. addLast (VCRichTextRun. HEADING, "Operation begun on "); 
commandRunList . addLast (VCRichTextRun . HEADING, new Date () . toString ( ) ) ; 
commandRunList. addLast (VCRichTextRun. EMPHASIZEDKEYWORD, ": " + operationName): 

pasteRichTextToTranscript (new VCRichTextParagraph ( "command" , commandRunList)) ; 



/** 

* Posts the cancel of an operation. 

* <p> 

* ©param operationName - String - the name of the operation 
*/ 

public void postOperationCanceled (String operationName) { 

getDesktopStatusViewer () . postWarningStatus ("Operation CANCELED: 
operationName) ; 



1 CANCELED c 

. toString {) 
3erationNam£ 

pasteRichTextToTranscript (new VCRichTextParagraph ( "command" , commandRunList) ) ; 

} 

/** 

* Posts the failure of an operation. 

* <p> 

* @param operationName - String - the name of the operation 
*/ 

public void postOperationFailed (String operationName) { 

getDesktopStatusViewer {) .postWarningStatus ("Operation FAILED: " + 
operationName) ; 

VCRichTextRunList commandRunList = new VCRichTextRunList () ; 

commandRunList. addLast (VCRichTextRim. ERROR, "Operation »>» FAILED «<« on 

") ; 

commandRunList . addLast (VCRichTextRun . ERROR, new Date ( ) . toString ( ) ) ; 
commandRunList. addLast (VCRichTextRun. ERROR, »: " + operationName); 

pasteRichTextToTranscript (new VCRichTextParagraph ( "command" , commandRunList) ) ; 



11 



* Posts the finish of an operation. 

* <p> 

* @parara operationUame - String - the name of the operatK 
piiblic void postOperationFinished (String operationName) { 



pasteRichTextToTranscript (new VCRichTextParagraph ( "command" , commandRunList) ) ; 



/** 

* Posts the VCRichTextParagraph to the 

* <p> 

* oparam commandRunParagraph the rich-text status to post 
public void poststatus {VCRichTextParagraph commandRunParagraph) { 

getDesktopStatusViewer 0 . postStatus (commandRunParagraph. toString ( ) ) ; 
pasteToTranscript (commandRunParagraph) ; 

} 

/** 

* Posts the status. 

* <p> 

* @param commandRunParagraph the rich-text status to post 
*/ 

public void poststatus (DVError error) { 

traceMessage(getClass 0 + " >> postStatus = " + error); 
getDesktopStatusViewer () . postErrorStatus (error . toString () ) ; 
pasteToTranscript (error) ; 

} 

/** 

* Posts the exception to the status viewer. 

* <p> 

* Oparam exception - DVException 
*/ 

public void postStatus (DVException exception) { 

traceMessage(getClass 0 + " >> postStatus (exception) = " + excepti< 
getDesktopStatusViewer 0 . postWarningStatus (exception. toString ( ) ) ; 
pasteToTranscript (exception) ; 

} 

* Posts the text to the status viewer. 

* <p> 

* Oparam statusText the status text to post 
public void postStatus (String statusText) { 

getDesktopStatusViewer 0 .postStatus (statusText) ; 



} 



* Posts a warning message to the status ■ 
piiblic void postWarningStatus (String message) { 

getDesktopStatusViewer ( ) .postWarningStatus (message) ; 
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pasteToTranscript (message) ; 

} 



/** 

* Called when a bound property is changed, 

* <p> 

* Oparam evt PropertyChangeEvent 
*/ 

public void propertyChange (PropertyChangeEvent event) { 
tracePropertyChange (event) ; 

if (event . getPropertyName (). equals ( "SQL Query Available")) { 
Ob j ect newValue = event . getNewValue ( ) ; 
if (newValue instanceof VCRichText Paragraph) 

postStatus ( (VCRichTextParagraph) newValue) ; 
else if (newValue instanceof MDbKodeTreeData) 

postStatus ( { (MDbNodeTreeData) newValue) .toStringO ) ; 
else if (newValue instanceof DVException) 
postStatus ( (DVException) newValue) ; 
else if (newValue instanceof DVError) 
postStatus ( (DVError) newValue) ,- 
} else if (event. getPropertyName () .equals ("DB Results Exception")) 

postStatus ( (DVException) event . getNewValue () ) ; 
else if ( event. getPropertyName 0 .equals ("DB Results Error")) 

postStatus ( (DVError) event . getNewValue ( ) ) ; 
else if (event .getPropertyName (). equals ( "Exception Raised")) 

postStatus ( (DVException) event . getNewValue () ) ; 
else if (event .getPropertyName () .equals ( "Error Raised")) 
postStatus ( (DVError) event . getNewValue ( ) ) ; 

else if 

(event .getPropertyName 0 .equals (IterationControllerFrame . ITERATION_CONTROL_EXCEPTION) ) 
postStatus ( (DVException) event . getNewValue () ) ; 
else if (event .getPropertyName (). equals (" Iteration Control Error")) 
postStatus ( (DVError) event . getNewValue ( ) ) ; 

else if 

(event . getPropertyName ( ) . equals (TranscriptController . CLEAR_DESKTOP_STATUS) ) 
clearDesktopStatus ( ) ; 
else if (event. getPropertyName 0 . equals (TranscriptController . OPERATION_BEGUN) ) 
postOperationBegun { (String) event .getNewValue ( ) ) ; 

else if 

(event . getPropertyName ( ) . equals (TranscriptController . OPERATION_CANCELED) ) 
postOperationCanceled { (String) event . getNewValue ( ) ) ; 
else if ( event. get PropertyNameO . equals (TranscriptController . OPERATIOH_FAILED) ) 
postOperationFailed( (String) event . getNewValue ( ) ) ; 

(event . getPropertyName ( ) . equals (TranscriptController . OPERATION_FINISHED) ) 

postOperationFinished { (String) event . getNewValue ( ) ) ; 
else if (event. getPropertyName 0 . equals (TranscriptController . POST_ERROR) ) 

postErrorStatus ( (String) event .getNewValue 0 ) ; 
else if (event .getPropertyName {) .equals (TranscriptController. POST_STATUS) ) 

postStatus ( (String) event .getNewValue ( ) ) ; 
else if (event .getPropertyName ( ) .equals (TranscriptController. POST_WARNING) ) 

postWarningStatus ( (String) event . getNewValue ( ) ) ; 

} 



* Saves the active transcript. 
*/ 

public void saveActionO { 
try { 

getTranscriptTabsViewer 0 . saveTranscript { ) ; 
refresh () ; 

} catch (CannotSaveAPreviousMasterTranscriptException exception) { 
postWarningStatus (exception. toStringO ) ; 

} 

} 

/** 

* "Save As" the active transcript. 
*/ 

ptiblic void saveAsAct ion ( ) { 
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try { 

getTranscriptTabsViewer ( ) . saveAsTranscript ( ) ; 

} catch (CannotSaveAsMasterTranscriptException exception) { 
postWarningStatus (exception . toString ( ) ) ; 

} 

} 

/** 

* Sets the host of the frame. 
*/ 

public void setDesktopView ( JLayeredPane desktopView) { 
this . desktopView = desktopView; 

} 



* Sets the previous executed command. 

* <p> 

* ©param coraraandText - String 
*/ 

public void setPreviousExecutedCommand (String commandText) { 
previousExecutedCommand = commandText ; 

} 
} 



package com . dcr . dvg . view . controller .transcript ; 
/** 

* @ (#) TranscriptControllerFrarae. java 




* <p> 

* The class <code>TranscriptControllerFrame</code> is the frame view for the 

* TranscriptControllerFrame . 



* ©author Edward L. Stull 

* ©version 1 . 5 

* ©since JDK 2 
*/ 

//34567890123456789012345678901234567890123456789*12345e789012345678901234557890 
import j ava . beans . PropertyChangeEvent ; 
import j avax . swing . JLayeredPane ; 

import com. dcr .dve. view. vcomponent .vctext .IVCEditor; 
import com. dcr .dvg. view. component . desktop. DVGDesktop; 

import com. dcr .dvg .view. component . text . rich . IRichTextFileEditorEmbedded; 
import com . dcr . dvg . view . control ler . DesktopControllerFrame ; 

public class TranscriptControllerFrame extends DesktopControllerFrame { 
/** 

* Constructor using the desktop view. 

* <p> 

* The context for the new frame is set by the desktop. 

* <p> 

* @param desktopView - JLayeredPane 
*/ 

piiblic TranscriptControllerFrarae (JLayeredPane desktopView) { 
super ( ) ; 

setDesktopView (desktopView) ; 
initialize () ; 

} 
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* Gets the (active) transcript editor. 

* <p> 

* ©return com. dor .dve .view. vcoraponent -VCEditor 
*/ 

public IVCEditor getEditor ( ) { 

return getTranscriptController ( ) . getEditor () ; 

} 

/** 

* Gets the Transcript Controller. 

* <p> 

* ©return transcriptController - TranscriptControllei 
*/ 

pTiblic TranscriptController getTranscriptController ( ) 
(TranscriptController) getviewer ( ) ; 



/** 

* Initializes. 
*/ 

pxiblic void initialize () { 

setviewer (new TranscriptController (getDesktopView ( ) > ) ; 



* Called when a bound property is changed, 

* <p> 

* @param evt PropertyChangeEvent 
*/ 

public void propertyChange (PropertyChangeEvent event) { 

/*debug trace*///System.out .println(getclass () + " »propertyChange on \"" 
event .get PropertyName 0 + "\" from " + event .getSource () .getClass ()) ; 
if (event .getPropertyName () . equals ( "isClosed" ) ) 

finalizeListenerlsClosed (event. getSource 0 ) ; 
else if (event .getPropertyName ( ) . equals (DVGDesktop . LAYER_PROPERTY) ) 

super .propertyChange (event) ; 

getTranscriptController () .propertyChange (event) ; // forward to the 
transcript viewer 
} 
} 



package com . dcr . dvg . view . controller . transcript ; 
* @(#)TranscriptTabsViewer. java 



' ©author Edward L. Stull 

' ©version 1 . 4 

' ©since JDK 2 



//34567890123456789012345S78901234S5789012345S789*123456789012345678901234567890 

import j ava . awt . Component ; 

import j ava . beans . PropertyChangeEvent ; 

import java. io. File ; 

import j ava . io . lOException; 



import java.util . Date; 









import 


j avax . swing 


RepaintManager ; 


import 


j avax . swing 


event . ChangeEvent ; 




j avax . swing 


event .ChangeListener, ■ 


import 


com . dcr . dve 


model . muser . MUserContext ; 


import 




view. vcomponent .vctext . VCRichTextEditor; 


import 




view. vcomponent .vctext . IVCTextFileEditor; 


import 


com . dcr . dve 


view. vcomponent .vctext . VCRichText Paragraph.; 


import 


com. dcr. dve 


view. vprocess . IVPView; 


import 


com . dcr . dve 


view. vprocess . VPTabsViewer ; 



//import c 
//import c 



..IVCEditor; 
..IVCTextFileEditor; 

import com. dcr . dvg .model . transcript . exception. CannotCloseMasterTranscriptExceptioi 
import 

com . dcr . dvg .model . transcript . exception . CannotSaveAPreviousMasterTranscriptExceptic 
import com . dcr . dvg . model . transcript . exception . CannotSaveAsMasterTranscriptExcept i< 
import com. dcr .dvg. model. transcript . MasterTranscript ; 
import com. dcr .dvg. model. transcript .Transcript; 
import com . dcr . dvg . util . throwable . DVException; 

import com . dcr . dvg . view . component . text . rich . IRichTextFileEditorEmbedded; 

piiblic class TranscriptTabsViewer extends VPTabsViewer implements IVPView { 

protected transient TranscriptController controller = null; 
protected transient TranscriptViewer masterTranscript = null; 

/** 

* Constructor based on the TranscriptController. 

* <p> 

* The context for the new frame is set by the desktop. 
*/ 

public TranscriptTabsViewer (TranscriptController controller) { 
super ( ) ; 

this -controller = controller; 
initialize () ; 

} 



* Adds a blank transcript . 

* <p> 

* Oparam tabName - String - name to use on the transcript ' s tab 
*/ 

public TranscriptViewer addBlankTranscript (String tabName) { 

TranscriptViewer newTranscript = new TranscriptViewer (this, 
addTab { tabName , newTranscript); 
setSelectedComponent (newTranscript) ; 



} 



newTranscript ; 



* Adds a blank transcript . 

* <p> 

* ©return transcript Viewer - TranscriptViewer 
*/ 

pxiblic TranscriptViewer addMasterTranscriptViewer { ) { 

TranscriptViewer newTranscriptViewer = new TranscriptViewer (this, 
MasterTranscript () ) ; 

addTab ( "Master" , newTranscriptViewer) ; 
setSelectedComponent (newTranscriptViewer) ; 

return newTranscriptViewer; 



: the transcripts 
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// close i 
makeMasterTranscriptAction 0 ; 
try { 

getActiveTranscript Viewer ( ) . close () ; 
} catch {lOException exception) { 

// just ignore for now, to late to do anything about it i 
// post message later 

} 

// close remaining transcripts 

for (int i = 1; i < getTranscriptCount ( ) ; i++) { 
setSelectedlndex(i) ; 
try { 

if {! isAMasterTranscript () ) 

getActiveTranscriptViewer 0 .closeO ; //"s; 

T transcript viewers 

} catch (lOException exception) { 

// just ignore for now, to late to do anything about it i 

// post message later 

} 

} 

revalidate () ; 



* Closes the i 
*/ 

public void closeTranscript () 

throws CannotCloseMasterTranscriptExceptii 

if (! 



refresh 0 ; 
} else { 

CannotCloseMasterTranscriptException exception = new 
CannotCloseMasterTranscriptException ( ) ; 

} ^ 

] 

/** 

* Creates the master transcript and viewer. 

* Assumes that the DVG home path exists with the proper permissions 
*/ 

public void createMasterTranscript { ) { 

String pathName = MUserContext .getDVGHomePathO ; 
String fileName = MUserContext . getUserld ( ) + (new 
Date ( ) ) . toString ( ) . replace { ' : ' , ' - ' ) ; 

File masterTranscriptFile = null ; 

try { 

new File (pathName, fileName) . createNewFile () ; 
masterTranscriptFile = new File (pathName, fileName); 
} catch {lOException exception) { 
fileName = null; 

System. out. printlnC'Error upon creating the Master Transcript 
fxle»:\n" + exception); 
} 

masterTranscript = addMasterTranscriptViewer () ; 
refresh ( ) ; 



editor . setEditable (false) ; 



editor. setFileBeingEdited(masterTraiiscriptFile) ; 



* Gets the active transcript viewer. 

* <p> 

* ©return transcriptviewer Transcript Viewer 
*/ 

p-ublic Transcriptviewer getActiveTranscriptViewer ( ) 

!Ssage(getClass() + " getActiveTranscrj 
SelectedlndexO ) ) ; 

(Transcriptviewer) getSelectedComponent () ; 



/** 

* Gets the controller for this component. 

* <p> 

* @return controller - TranscriptController 
*/ 

public TranscriptController getController ( ) { 
return controller; 

} 

* Gets the transcript's editor. 

* <p> 

* ©return editor IRichTextFileEditorEmbedded 
*/ 

public IRichTextFileEditorEmbedded getEditorO { 

1 getActiveTranscriptViewer () . getTranscriptEdit 



} 



* This a standard interface to access the component's 

* <p> 

* Gets the Master Transcript (viewer) . 

* <p> 

* ©return raasterTranscript - Transcriptviewer 
*/ 

pxoblic Transcriptviewer getMasterTranscript { ) { 
1 masterTranscript ; 



} 



* Gets the Transcript at the specified index in the tab ^ 

* <p> 

* ©return masterTranscript - Transcriptviewer 
*/ 

public Transcriptviewer getTranscriptAt (int index) { 

traceMessage (getClass 0 + " getTranscriptAt () =" + getTitleAt ( index) ) 
(Transcriptviewer) getComponentAt (index) ; 



} 



/** 

* Gets the transcript count . 

* <p> 

* ©return transcriptCount - int 
*/ 

public int getTranscriptCount ( ) { 
1 getTabCount ( ) ; 



} 



* Initializes this viewer. 
*/ 

public void initialize {) { 

instance = this; // for inner class reference 
createMasterTranscript ( ) ; 

/** 

* Answer true if the active transcript is the master transcript. 

* <p> 

* ©return mode boolean 
*/ 

public boolean isAMasterTranscript { ) { 

^ return getActiveTranscriptViewer {). isAMasterTranscript () ; 

* Answer true if the active transcript is the current (tab 0) master t 

* <p> 

* ©return mode boolean 
*/ 

public boolean isCurrentMasterTranscript () { 
return getSelectedlndex ( ) == 0; 

} 

/** 

* Answer true if the active transcript is unnamed. 

* <p> 

* ©return mode boolean 
*/ 

public boolean isCurrentTranscript Unnamed ( ) { 

^ return getActiveTranscriptViewer () .getFileBeingEditedO == null; 

/** 

* Makes the Master Transcript the active transcript. 
*/ 

public void makeMasterTranscriptAction ( ) { 
setSelectedlndex(O) ; 

} 

* Creates and opens a "new" Transcript. 
*/ 

public void newTranscript () { 

newTranscript (">> NEW <<"); 

} 

/** 

* Creates and opens a "new" Transcript with the specified name. 

* ®param tabName - String - name of the new transcript 
public Transcriptviewer newTranscript (String tabName) { 

TranscriptViewer newTranscript = addBlankTranscript (tabName) ; 
refresh () ; 

return newTranscript; 

} 

/** 

* O] 

* Ci 

V 

public void openTranscript () { 
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File file = getActiveTranscriptViewer ( ) .getFileToOpen ( ) ; 

if (file != null) { 

Transcript viewer newTranscript = addBlankTranscript (f ile.getName () ) ; 
getActiveTranscriptViewer () . openTranscript (f ile) ; 



refresh ( ) ; 

} 



* Pastes rich text to the transcripts. 

* <p> 

* ©param commandRunParagraph - VCRichTextParagraph 
*/ 

public void pasteRichTextToTranscript (VCRichTextParagraph commandRunParagraph) { 

for {int i=0; i < getTranscriptCount () ; i++) 

if (isCurrentMasterTranscript 0 || (! isAMasterTranscript { ) ) ) 

( (VCRichTextEditor)getTranscriptAt (i) . getTranscriptEditor ( ) ) . appendParagraph ( co 
mmandRunParagraph) ; 

} 

/** 

* Called when a bound property is changed, 

* <p> 

* @param evt PropertyChangeEvent 
*/ 

public void propertyChange ( PropertyChangeEvent event) { 
tracePropertyChange (event) ; 

if (event. getPropertyNameO .equalsC'Exception Raised")) 

getController () .propertyChange (event) ; 
else if (event.getPropertyNameO .equals ("Error Raised")) 

getController () . propertyChange ( event ) ; 



/** 

* "Save As" the active transcript. 
*/ 

public void saveAsTranscript {) 

throws CannotSaveAsMasterTranscriptException { 

getActiveTranscriptViewer () . saveAsTranscript ( ) ; 

setCurrentTranscriptTabTitle () ; 

} 



* Saves the active transcript. 
*/ 

piiblic void saveTranscript () 

throws Cannot SaveAPreviousMasterTranscriptExcept ion { 

if ((! isAMasterTranscript 0 ) || isCurrentMasterTranscript () ) { 

getActiveTranscriptViewer 0 . saveTranscript { ) ; 
} else { 

CannotSaveAPreviousMasterTranscriptException exception = new 
CannotSaveAPreviousMasterTranscriptExceptionO ; 
throw exception; 

} 

} 

* Sets the title of the current transcript . 
V 

public void setCurrentTranscriptTabTitle () { 

File file = getActiveTranscriptViewer () .getFileBeingEditedO ; 

if (file != null) { 

setTitleAt (getSelectedlndex { ) , f ile . getName ( ) ) ; 
refresh ( ) ; 
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} 

} 
} 



package com.dcr . dvg .view. controller . transcript ; 
/** 

* @(#) TranscriptViewer . java 

* <p> 




* <p> 

* The class <code>TranscriptViewer</code> is the view of a loaded transcript. 

* <p> 

* ©author Edward L. Stull 

* ©version 1 . 3 

* ©since JDKl . 1 
*/ 

//34567890123456 789 0123456 789012 34 5578 9012 345678 9*1234 5678 901234 567 890123456 7890 
import j ava . awt . Component ; 

import j ava -beans . PropertyChangeListener ; 
import j ava . beans . Property ChangeEvent ; 
import java.io.IOException; 
import j ava. io. File; 

import com . dcr . dve . view . vcomponent . vcpanel . VCScrollViewer ; 
import com.dcr .dve. view. vcomponent .vctext . IVCTextFileEditor; 
import com.dcr .dve. view. vcomponent .vctext . VCRichTextEditor ; 
import com.dcr .dve. view. vprocess . VPRichTextEditor; 

import com. dcr . dvg .model .transcript . exception. CannotSaveAsMasterTranscriptException; 
import com . dcr . dvg . model . transcript . MasterTranscript ; 
import com. dcr. dvg. model. transcript . Transcript ; 

import com.dcr .dvg. view. component . text . ITextFileEditorEmbedded; 

import com . dcr. dvg. view. component . text . rich. IRichTextFileEditorEmbedded; 

public class TranscriptViewer 
extends VCScrollViewer 
implements PropertyChangeListener { 

protected TranscriptTabsViewer controller = null; 
protected VPRichTextEditor editor = null; 

/** 

* Constructor. 

* <p> 

* @param controller - TranscriptTabsViewer 

* ®param transcript - Transcript 
*/ 

piiblic TranscriptViewer (TranscriptTabsViewer controller. Transcript transcript) { 
this . controller = controller ; 

editor = new VPRichTextEditor (transcript) ; // initial document 
editor .addPropertyChangeListener (this) ; 
editor. createDeEaultStyles 0 ; 

setviewportview (editor) ; 
setBackingStoreEnabled(true) ; 

} 



/** 

* Closes the transcript viewer and its transcript (file) . 
*/ 

public void close ( ) 
throws lOException { 

closeTranscript {> ; 

} 



* Closes a transcript . 
*/ 

public void closeTranscript () 
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throws lOException { 

getTranscriptEditor 0 .saveFileO ; 
getTranscriptEditor () . closeAction ( ) ,- 

} 

/** 

* Gets the controller for this component . 

* <p> 

* ©return controller - TranscrxptTabsViewer 
public TranscriptTabsViewer getController ( ) { 

1 controller; 



* Gets the transcript file being edited. 

* <p> 

* ©return file - File 

public File getFileBeingEdited () { 

return getTranscriptEditor { ) .getFileBeingEdited ( ) ; 

} 

/** 

* Gets a transcript file to open. 

* <p> 

* ©return file - File 
public File getFileToOpenO { 

return getTranscriptEditor () .getFileToOpenO ; 

} 

/** 

* Gets the transcript's editor. 

* ©return editor - IRichTextFileEditorEmbedded 

public IRichTextFileEditorEmbedded getTranscriptEditor ( ) { 
(IRichTextFileEditorEmbedded) editor; 



* Answer true if the active transcript is the 

* <p> 

* ©return mode boolean 



public boolean isAMasterTranscript ( ) { 

getTranscriptEditor { > . getDocument ( ) instanceof MasterTranscript ; 



* Opens an existing transcript file, 
public void openTranscript {File file) { 
getTranscriptEditor { ) .open(file) ; 



} 



* Called when a bound property is changed, 

* <p> 

* ©param evt PropertyChangeEvent 

public void proper tyChange (PropertyChangeEvent event) { 



if (TRACE) 

tracePropertyChange (event ) 



if (event . get Proper tyName ( ) . equals { "Exception Raised" ) ) 
getController 0 . proper tyChange (event) ; 

else if ( event. getPropertyNameO -equals ("Error Raised")) 
getController 0 .propertyChange (event) ; 



* "Save As" tlie transcript. 
*/ 

public void saveAsTranscript ( ) 

throws CannotSaveAsMasterTranscriptException { 

if (1 isAMasterTranscriptO ) { 

getTranscriptEditor () . saveAsActionO ; 
} else { 

CannotSaveAsMasterTranscriptException exception = 
CannotSaveAsMasterTranscriptException ( ) ; 
throw exception; 

} 



* Saves the active transcript to its 
public void saveTranscript C) { 

getTranscriptEditor 0 .saveActi' 

} 
} 

Right-click for Help 

package com . dcr . dve . view . vcomponent 

* ®(#) IVCMenuItem. java 



IVCMenuItem provides a common interface for VCMenuItem compoi 



* ©author Edward L. Stull 

* ©version 1.1 

* ©since JDK 2 



//345678901234567890a2345678901234567890123456789*12345678901234567890: 



import javax. swing. Icon; 

import javax. swing .MenuElement ; 

import j avax . swing . MenuSelect ionManager ; 

import com . dcr . dve . view . vcomponent . vccontrol . IVCCHelp ; 

public interface IVCMenuItem extends IVCCHelp { 

^* Adds an Action Listener 

* <p> 

* Oparam listener - ActionLiStener 

public void addActionListener (ActionListener lis 



^ * Initializes the menu item and register the result with the 

* hashtable so that it can be fetched with getMenuItem { ) . 

* <p> 

* @see #getMenuItem 
*/ 

public void initialize () ; 



* Overrides the processing of the event modifiers. 

* <p> 

* Process a mouse event, event is a MouseEvent with source being the receiving 
component . 

* componentPath is the path of the receiving MenuEletnent in the menu 

* hierarchy, manager is the MenuSelectionManager for the menu hierarchy. 

* This method should process the MouseEvent and change the menu selection if 

* by using MenuSelectionManager ' s API. 

* <p> 

* Note: you do not have to forward the event to sub - component s . This is done 
automatically 

* by the MenuSelectionManager 
*/ 

public void processMouseEvent (MouseEvent event, MenuElement path[], 
MenuSelectionManager manager) ; 

/** 

* Sets the Action Command 

* <p> 

* ®param commandName java. lang. String 
*/ 

pxiblic void setActionCommand (String commandUame) ; 

* Sets the enable mode. 

* <p> 

* ©param mode boolean 
*/ 

public void setEnabled (boolean mode) ; 
/** 

* Sets the horizontal text position 

* <p> 

* ®param alignment - int 
*/ 

piiblic void setHorizontalTextPosition{int alignment); 
/** 

* Sets the icon 

* <p> 

*/ 

public void setlcondcon icon); 



* Sets the mnemonic. 

* <p> 

* ®param keyAccelerator - int (char) 
*/ 

public void setMnemonic ( int keyAccelerator); 
/** 

* Sets the text . 

* <p> 

* @param text java. lang . String 
*/ 

public void set Text (String text); 



package com . dcr . dve .view. vcomponent .vccontrol; 
/** 

* @(#)IVCCHelp. java 

* <p> 




* <p> 

* IVCCHelp provides a common interface for help-related components. 

* <p> 
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* ©author Edward L. Stull (ID: ELS) 

* (aversion 2 . 006 

* ©since JDK 2 
*/ 

//34567890123456789012345S78901234567890123456789*1234 56789012345678901234567890 

import j ava . awt . event . MouseEvent ; 

import j avax . swing . MenuElement ; 

import j avax . swing . MenuSelectionManager ; 

public interface IVCCHelp { 

* Gets the name of the command. 

* <p> 

* ©return name j ava . lang . String 
*/ 

public String getCommandName ( ) ; 



* Gets the default name of the command. 

* <p> 

* ©return name j ava . lang . String 
*/ 

public String getDef aultName ( ) ; 



* Gets the string associated with the resource tag. 

* <p> 

* (Sparam name j ava . lang. String 

* ©return name j ava . lang . String 
*/ 

public String getResourceString (String resourceTagMame) ; 
} 



package com . dcr . dve . view . vcomponent . vccont rol ; 
/** 

* @(#)VCControlKit. java 

* <p> 




* <p> 

* An <code>VCControlBar</code> is a set of helper methods supporting 

* the operation of controls, that is, active components. Currently, this 

* kit provides context help support in menu and toolbar controls . 

* <p> 

* ©author Edward L. Stull 

* ©version 2 . 11 

* ©since JDK 2 
*/ 

//3 4567890 123456 789 012345 678 901234 5678901234567 89*1234 567 890 123456 789012 345 678 90 

import j ava . awt . event . MouseEvent ; 

import j avax . swing . MenuElement ; 

import j avax . swing . MenuSelectionManager ; 

import com . dcr . dve . view . vcomponent . vchtml . VCDef aultBrowser ; 

public class VCControlKit extends Object { 
/** 

* Gets the URL text for the contextual help name. 

* <p> 

* ©param helpTag - a resource tag for help 

* ©return contextHelpUrlName 
*/ 

public static String getContextHelpUrlLabelFor (String helpTag) { 
return helpTag + getContextHelpUrlLabelSuf f ix () ; 

} 
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* Gets the label for the contextual help URL. 

* <p> 

* (Sreturn contextHelpUrlLabel 
*/ 

public static String getContextHelpUrlLabelSuf f ix ( ) { 
return "HelpUrl"; 

} 



/** 

* Gets the URL text for the contextual help name using a view that implements 

* the help interface. 

* <p> 

* @param helpview - a view that implements the help interface 

* ©return contextHelpUrlText 
*/ 

public static String getContextHelpUrlTextFor (IVCCHelp helpView) { 

return helpView. getResourceString(helpView. getCommandName C) + 
getContextHelpUrlLabelSuff ixO ) ; 

} 



* Answer if this is a help context event . 

* <p> 

* @param event - the mouse event . 

* (greturn boolean 

* @see j ava . awt . event . MouseListener 

* @see java.awt .ComponentSaddMouseListener 

* @see java.awt .Component#enableEvents 
*/ 

public static boolean isContextHelpEvent (MouseEvent event) { 

return ( (event . getID ( ) == MouseEvent .MOUSE_RELEASED) 

&&: { (event. getModifiersO & MouseEvent . META_MASK) != 0) ) ; 

} 



* Launch the help facility for a view that implements 

* the help interface. 

* <p> 

* @param helpview - a view that implements the help interface 
*/ 

public static void launchViewerContextHelpUsing ( IVCCHelp helpView) { 

String def aultHelpUrlText = getContextHelpUrlTextFor (helpView) ; 

String fileSep = System.getProperty( "file . separator ") ; // e.g., "/" 

String helpUrlPath = System. getProperty ("user .dir") + fileSep + "Help" + 
fileSep; 

VCDefaultBrowser browser = new VCDef aultBrowser (> ; 
if (defaultHelpUrlText == null) 

browser. displayURL(helpUrlPath + "Action" + fileSep + 
help View.getDefaultNameO .replace { ' ', '_') + ".htm"); 
else 

browser. displayURL{helpUrlPath + defaultHelpUrlText); 

} 

/** 

* Launch the help facility for this viewer's context using a help URL text. 

* <p> 

* @param helpUrlText - String 
*/ 

public static void launchViewerContextHelpUsing (String helpUrlText) { 

if (helpUrlText == null) 

helpUrlText = "index.htm"; 

String fileSep = Systera.getProperty( "file . separator" ) ; // e.g., "/" 
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VCDef aultBrowser browser = new VCDef aultBrowser ( ) ; 

browser. displayURL(System.getProperty("user.dir") + fileSep + "Help" + fileSep 
• helpUrlText) ; 



package com. dcr .dve .view. vcoraponent .vctool; 
/** 

* ®(#) VCToolBarButton. java 



I of a button for the ^ 
Edward L. Stull 

09 

JDK 2 
*/ 

//345e789012345S7890123456789012345S789012345S789+12: 



* An implement at i< 

* <p> 

* ©author 

* ©since 



1567890123456789012345S7890 



import j a^ 

import ja^ 

import ja^ 

import j a' 

import j a' 

import j a' 

import j a^ 

import j a' 

import j a' 

import j a: 

import ( 
import < 
import ( 
import ( 
import < 
import < 

import < 



- . awt . event . MouseEvent ; 

net. URL; 
L.util .Hashtable; 
L . ut il . Resour ceBundle ; 

LX . swing . Imagelcon ; 
jz . swing . border . Border ; 
jc . swing . border . CompoundBorder ; 
LX . swing .border . EmptyBorder ; 
LX . swing .border . EtchedBorder ; 

m . dcr . dve . view . vcomponent . VCAct ion ; 
im . dcr . dve .view . vcomponent . VCPushButton ; 
im . dcr . dve . view . vcomponent . vcbutton . VCButt on ; 
m. dcr . dve .view. vcomponent . vccontrol . IVCCHelp; 
m . dcr . dve .view . vcomponent . vccontrol . VCControlKit ; 
im. dcr. dve. view. vcomponent .vchtml . VCDef aultBrc 



om . dcr . dvg . mode 1 .ResourcesKit ; 

lass VCToolBarButton extends VCPushButton implements IVCCHelp { 

itroHer = null; // the controller for thi 
.tName; 

used for tag in the resource 



protected VCToolBar 
protected String defaultNai 
protected String tagName; , 
protected Imagelcon imageli 

protected final static Border eraptyBorder = 
protected final static Border etchedBorder 

= new CompoimdBorder (new EtchedBorder () , emptyBorder) ; 



s component 



EmptyBorder (2, 2, 2, 2); 



• Constructor . 



; VCToolBar Butt O] 



jolBar controller. String tagName) 



initialize (controller. 



* Launchs the help facility for this 
*/ 

public void contextHelpActionO { 

VCControlKit . launchViewerContextHelpUsing (this 
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/** 

* Gets the action for the specified command. 

* <p> 

* ©param String - command 
*/ 

protected VCAction getAction (String command) { 

. (VCAction) getCommandsO .get (command) ; 



* Gets the action suffix string. 

* <p> 

* ©return image - suffix 
*/ 

pixblic String getActionSuf f ix ( ) { 

getController () .getActionSuf fix ( ) ; 



/** 

* Get s Y al ignment . 

* <p> 

* ©return alignment 
*/ 

public float get Al ignment Y() 
i.5f ; 



/** 

* Gets the action name for the menu item as specified in the 3 

* <p> 

* @param String- command 
*/ 

protected VCAction getButtonAction (String commandName) { 

String actionNarae = getResourceString (commandName + getActionSuf fix ()) ; 



. name to that of the command 

getAction (act ionName) ; 
} 

* Gets the name (that is, tag name) for the buttom that is used by the resource. 

* <p> 

* (Sreturn tagName - j ava . lang . String 
*/ 

piiblic String ge t CommandName ( ) { 
return tagName; 

} 



* Gets the commands of the controller. 

* <p> 

* ©return commands - java .util -Hashtable; 
*/ 

piiblic Hashtable getCommandsO { 

1 getController 0 .getCommandsO ; 



' Gets the controller for this resource-employing component. 
' <p> 

itroller - the VCToolBar controller 
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public VCToolBar getController ( ) { 
I controller; 



/** 

* Gets the name for the buttoiti that is used by t 

* <p> 

* ©return defaultName - String 
pxiblic String getDef aultName {) { 

return defaultName; 

} 

^* Gets the image (icon) based on the image name. 

* <p> 

* ©param imageName j ava . lang. String 

* ©return Imagelcon 

public Imagelcon getlmagelcon (String imageName) { 

L getController 0 .get Image I con (imageName) ; 



* Gets the image suffix string. 

* <p> 

* ©return imageSuffix - String 
*/ 

piiblic String getlmageSuf f ix() { 

return getController ( ) .getlmageSuf fix () ; 

} 

/** 

* Gets the label suffix string. 

* <p> 

* ©return labelSuffix - String 
*/ 

public String getLabelSuf f ix ( ) { 

1 getController 0 .getLabelSuf fix ( ) ; 



) 



public URL getResource (String key) { 

1 getController () .getReso^ 



/** 

* Gets the resources. 

* <p> 

* ©return ResourceBundle 

public ResourceBundle getResources ( ) { 

1 getController 0 .getResources () ; 



' from a super class 
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* Gets a resource string from the local resource or from a super class resource. 

* <p> 

* @param key java . lang. String 

* ©return java . lang . String 

public String getResourceString {String key) { 

return get Controller () .getResourceString (key) ; 

} 



* Gets the image suffix string. 

* <p> 

* ©return tipSuffix - String 
public String getTipSuf f ix{ ) { 

return getController ( ) . getTipSuf fix ( ) ; 

} 



* Initializes the menu item and register the result with the menuitem 

* hashtable so that it can be fetched with getMenuItemO . 

* <p> 

* ©param controller 

* @param tagName name used for tag in the resource 

* ®see #getMenuItem 

*/ s , 

public void initialize (VCToolBar controller. String tagName) ( 

setController (controller) ; 

setUI ( ) ; 

setComtnandName (tagName) ; 
setLabelFromResource ( ) ; 

setCrossActionAndButtonRegistration ( ) ; 
setlmageFromResource {) ; 
setToolTipText ( > ; 

} 



* Answer if the icon is to be shown. 
*/ 

public boolean isShowIconO { 



* Override to process 

* <p> 

* Processes mouse ev( 

* dispatching them t< 

* <code>MouseLii 



3 component by 



Its occurring on 
any registered 
:/code> objects. 

* <p> 

* This method is not called unless mouse events are 

* enabled for this component. Mouse events are enabled 

* when one of the following occurs: 

* <p><ul> 

* <li>A <code>MouseListener</code> object is registered 

* via <code>addMouseListener</code>- 

* <li>Mouse events are enabled via <code>enableEvents</code> , 



, - the mouse event . 

awt . event . MouseEvent 

awt . event . MouseListener 

awt .ComponentftaddMouseListener 

awt . Component #enableEvents 



piiblic void processMouseEvent (MouseEvent event) 



if (VCControlKit . isContextHelpEvent (event) ) 

VCControlKit . launchViewerContextHelpUsing (thi; 
//( (MouseListener)mouseListener .a) .model -setP; 
/ /mouseListener .model . setPressed ( false) ; 

else 

super .processMouseEvent (event) ; 



^ * Sets tlie name for the buttora that is used by the 3 

* <p> 

* (gparam tagName 

public void setCommandName (String tagName) { 
this. tagName = tagName; 



} 



:e-employing component . 

* <p> 

* @param controller - the VCToolBar controller 
public void setController (VCToolBar controller) { 

this . controller = controller ,- 



} 



; void setCrossActionAndButtonRegistrationO { 
String commandName = getCommandName ( ) ; 
VCAction action = getButtonAction(comraandNarae) ; 



tion 1= null) { 

// set the action commnand name that is included in the event sent tc 

setActionCommandC (String) action. getValue{ act ion. NAME) ) ; 
addActionListener (action) ; 
setEnabled (action. isEnabledO ) ; 
setlcon (action. getlconO ) ; 

action. addPropertyChangeListener (new VCToolBarButtonListener (this) ) ; 
} else { 

setEnabled (false) ; 

/*debug trace*///System. err .println( "Action for button \"" + 
commandName + "\" not resolved."); 

ResourcesKit . f ireResourceTagError (getResources ( ) , getDef aultName ( ) ) ; 



} 



* Sets the default name for the buttora. 

* <p> 

* ®param defaultName 
*/ 

public void setDef aultName (String defaultName) 
this . defaultName = defaultName; 

} 
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public void setlraageFroraEesource ( ) { 

if (getlconO == null) { // if not specified by the action 
String commandName = getCotnmandName ( ) ; 

URL url = getRe source (commandName + getlmageSuf f ix ( ) ) ; 
if (url != null) { 

if (isSliowIconO ) 

setHor iz ont alText Pes it ion (VCButton . CENTER) ; 

else 

setHor iz ont alText Pes it ion (VCButton . LEFT ) ; 
setlcon (new 

Imagelcon (java. awt . Toolkit .getDef aultToolkit () .get Image (url) ) ) ; 
} else 



* Sets the menu item's label in the menu list. 

* <p> 

* Oparam command name 
*/ 

protected void setLabelPromResource () { 

String commandName = getCommandName ( ) ; 

String label = getResourceString (commandName + getLabelSuf f ix ( ) ) ; 

//defalut the label 
if (label == null) 

label = getResourceString (commandName + getActionSuf f ix ( ) ) ; 
if (label == null) 

label = commandName; 

//setText (label) ; 
setDefaultName (label) ; 

} 

/** 

* Answer if the icon is to be shown. 
*/ 

public boolean setshowlcon () { 



} 



* For tool bar buttons, override text set to only set the name 

* and the tool tip. 

* <p> 

* @param buttonText - String - the text to display with the button 
*/ 

public void setText (String buttonText) { 

setDefaultName (buttonText) ; 
setToolTipText (buttonText) ; 

} 



* Sets the tool tip text based on the resource specification. 
*/ 

protected void setToolTipText ( ) { 

String tip = getResourceString (getCommandName ( ) + getTipSuf f ix () ) ; 
if (tip != null) 

super . setToolTipText (tip) ; 

else 

super . setToolTipText (getDef aultName ( ) ) ; 



* Sets UI for this component . 
*/ 

Jiiblic void setUI 0 { 

setMargin (new Insets (1 , 1, 1 , 1) ) 



setReguestFocusEnabled (false) ; 
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